[ { "path": ".appveyor.yml", "content": "version: \"{branch}.{build}\"\n\nenvironment:\n matrix:\n - TOXENV: py36-no-ext\n PYTHON: \"C:\\\\Python36-x64\"\n PYTHON_VERSION: \"3.6.x\"\n PYTHON_ARCH: \"64\"\n\n - TOXENV: py37-no-ext\n PYTHON: \"C:\\\\Python37-x64\"\n PYTHON_VERSION: \"3.7.x\"\n PYTHON_ARCH: \"64\"\n\n - TOXENV: py38-no-ext\n PYTHON: \"C:\\\\Python38-x64\"\n PYTHON_VERSION: \"3.8.x\"\n PYTHON_ARCH: \"64\"\n\n # - TOXENV: py39-no-ext\n # PYTHON: \"C:\\\\Python39-x64\\\\python\"\n # PYTHONPATH: \"C:\\\\Python39-x64\"\n # PYTHON_VERSION: \"3.9.x\"\n # PYTHON_ARCH: \"64\"\n\ninit: SET \"PATH=%PYTHON%;%PYTHON%\\\\Scripts;%PATH%\"\n\ninstall:\n - pip install tox\n\nbuild: off\n\ntest_script: tox\n\nnotifications:\n - provider: Email\n on_build_success: false\n on_build_status_changed: false\n" }, { "path": ".coveragerc", "content": "[run]\nbranch = True\nsource = sanic\nomit =\n site-packages\n sanic/__main__.py\n sanic/server/legacy.py\n sanic/compat.py\n sanic/simple.py\n sanic/utils.py\n sanic/cli\n sanic/pages\n\n[html]\ndirectory = coverage\n\n[report]\nexclude_lines =\n no cov\n no qa\n noqa\n NOQA\n pragma: no cover\n TYPE_CHECKING\nskip_empty = True\n" }, { "path": ".gitattributes", "content": "* text=auto\n" }, { "path": ".github/CODEOWNERS", "content": "* @sanic-org/sanic-release-managers\n/sanic/ @sanic-org/framework\n/tests/ @sanic-org/framework\n" }, { "path": ".github/FUNDING.yml", "content": "# These are supported funding model platforms\n\ngithub: # Replace with up to 4 GitHub Sponsors-enabled usernames e.g., [user1, user2]\npatreon: # Replace with a single Patreon username\nopen_collective: sanic-org # Replace with a single Open Collective username\nko_fi: # Replace with a single Ko-fi username\ntidelift: # Replace with a single Tidelift platform-name/package-name e.g., npm/babel\ncommunity_bridge: # Replace with a single Community Bridge project-name e.g., cloud-foundry\nliberapay: # Replace with a single Liberapay username\nissuehunt: # Replace with a single IssueHunt username\notechie: # Replace with a single Otechie username\ncustom: # Replace with up to 4 custom sponsorship URLs e.g., ['link1', 'link2']\n" }, { "path": ".github/ISSUE_TEMPLATE/bug-report.yml", "content": "name: 🐞 Bug report\ndescription: Create a report to help us improve\nlabels: [\"bug\", \"triage\"]\nbody:\n - type: checkboxes\n id: existing\n attributes:\n label: Is there an existing issue for this?\n description: Please search to see if an issue already exists for the bug you encountered.\n options:\n - label: I have searched the existing issues\n required: true\n - type: textarea\n id: description\n attributes:\n label: Describe the bug\n description: A clear and concise description of what the bug is, make sure to paste any exceptions and tracebacks using markdown code-block syntax to make it easier to read.\n validations:\n required: true\n - type: textarea\n id: code\n attributes:\n label: Code snippet\n description: |\n Relevant source code, make sure to remove what is not necessary. Please try and format your code so that it is easier to read. For example:\n\n ```python\n from sanic import Sanic\n\n app = Sanic(\"Example\")\n ```\n validations:\n required: false\n - type: textarea\n id: expected\n attributes:\n label: Expected Behavior\n description: A concise description of what you expected to happen.\n validations:\n required: false\n - type: dropdown\n id: running\n attributes:\n label: How do you run Sanic?\n options:\n - Sanic CLI\n - As a module\n - As a script (`app.run` or `Sanic.serve`)\n - ASGI\n validations:\n required: true\n - type: dropdown\n id: os\n attributes:\n label: Operating System\n description: What OS?\n options:\n - Linux\n - MacOS\n - Windows\n - Other (tell us in the description)\n validations:\n required: true\n - type: input\n id: version\n attributes:\n label: Sanic Version\n description: Check startup logs or try `sanic --version`\n validations:\n required: true\n - type: textarea\n id: additional\n attributes:\n label: Additional context\n description: Add any other context about the problem here.\n validations:\n required: false\n\n" }, { "path": ".github/ISSUE_TEMPLATE/config.yml", "content": "blank_issues_enabled: false\ncontact_links:\n - name: Questions and Help\n url: https://community.sanicframework.org/c/questions-and-help\n about: Do you need help with Sanic? Ask your questions here.\n - name: Discussion and Support\n url: https://discord.gg/FARQzAEMAA\n about: For live discussion and support, checkout the Sanic Discord server.\n" }, { "path": ".github/ISSUE_TEMPLATE/feature-request.yml", "content": "name: 🌟 Feature request\ndescription: Suggest an enhancement for Sanic\nlabels: [\"feature request\"]\nbody:\n - type: checkboxes\n id: existing\n attributes:\n label: Is there an existing issue for this?\n description: Please search to see if an issue already exists for the enhancement you are proposing.\n options:\n - label: I have searched the existing issues\n required: true\n - type: textarea\n id: description\n attributes:\n label: Is your feature request related to a problem? Please describe.\n description: A clear and concise description of what the problem is. Ex. I'm always frustrated when [...]\n validations:\n required: false\n - type: textarea\n id: code\n attributes:\n label: Describe the solution you'd like\n description: A clear and concise description of what you want to happen.\n validations:\n required: true\n - type: textarea\n id: additional\n attributes:\n label: Additional context\n description: Add any other context about the problem here.\n validations:\n required: false\n\n" }, { "path": ".github/ISSUE_TEMPLATE/rfc.yml", "content": "name: 💡 Request for Comments\ndescription: Open an RFC for discussion\nlabels: [\"RFC\"]\nbody:\n - type: input\n id: compare\n attributes:\n label: Link to code\n description: If available, share a [comparison](https://github.com/sanic-org/sanic/compare) from a POC branch to main\n placeholder: https://github.com/sanic-org/sanic/compare/main...some-new-branch\n validations:\n required: false\n - type: textarea\n id: proposal\n attributes:\n label: Proposal\n description: A thorough discussion of the proposal discussing the problem it solves, potential code, use cases, and impacts\n validations:\n required: true\n - type: textarea\n id: additional\n attributes:\n label: Additional context\n description: Add any other context that is relevant\n validations:\n required: false\n - type: checkboxes\n id: breaking\n attributes:\n label: Is this a breaking change?\n options:\n - label: \"Yes\"\n required: false\n" }, { "path": ".github/stale.yml", "content": "# Number of days of inactivity before an issue becomes stale\ndaysUntilStale: 90\n# Number of days of inactivity before a stale issue is closed\ndaysUntilClose: 30\n# Issues with these labels will never be considered stale\nexemptLabels:\n - bug\n - urgent\n - necessary\n - help wanted\n - RFC\n# Label to use when marking an issue as stale\nstaleLabel: stale\n# Comment to post when marking an issue as stale. Set to `false` to disable\nmarkComment: >\n This issue has been automatically marked as stale because it has not had\n recent activity. It will be closed if no further activity occurs. If this \n is incorrect, please respond with an update. Thank you for your contributions.\n# Comment to post when closing a stale issue. Set to `false` to disable\ncloseComment: false\n" }, { "path": ".github/workflows/codeql-analysis.yml", "content": "name: \"CodeQL\"\n\non:\n push:\n branches:\n - main\n - current-release\n - \"*LTS\"\n pull_request:\n branches:\n - main\n - current-release\n - \"*LTS\"\n types: [opened, synchronize, reopened, ready_for_review]\n schedule:\n - cron: '25 16 * * 0'\n\njobs:\n analyze:\n if: github.event.pull_request.draft == false\n name: Analyze\n runs-on: ubuntu-latest\n\n strategy:\n fail-fast: false\n matrix:\n language: [ 'python' ]\n\n steps:\n - name: Checkout repository\n uses: actions/checkout@v2\n\n - name: Initialize CodeQL\n uses: github/codeql-action/init@v1\n with:\n languages: ${{ matrix.language }}\n\n - name: Autobuild\n uses: github/codeql-action/autobuild@v1\n\n - name: Perform CodeQL Analysis\n uses: github/codeql-action/analyze@v1\n" }, { "path": ".github/workflows/coverage-upload.yml", "content": "name: Upload coverage to Codecov\non:\n workflow_run:\n workflows: [\"Coverage check\"]\n types:\n - completed\n\njobs:\n upload:\n name: Upload coverage\n runs-on: ubuntu-latest\n if: github.event.workflow_run.conclusion == 'success'\n\n steps:\n - name: Checkout\n uses: actions/checkout@v4\n with:\n ref: ${{ github.event.workflow_run.head_sha }}\n\n - name: Download coverage artifact\n uses: dawidd6/action-download-artifact@v6\n with:\n name: coverage-report\n run_id: ${{ github.event.workflow_run.id }}\n github_token: ${{ secrets.GITHUB_TOKEN }}\n\n - name: Get PR number\n id: pr\n run: |\n if [ \"${{ github.event.workflow_run.event }}\" == \"pull_request\" ]; then\n PR_NUMBERS=$(gh pr list --search \"${{ github.event.workflow_run.head_sha }}\" --state open --json number --jq '.[].number')\n PR_COUNT=$(printf \"%s\\n\" \"$PR_NUMBERS\" | sed '/^$/d' | wc -l | tr -d ' ')\n if [ \"$PR_COUNT\" -eq 0 ]; then\n echo \"Error: No open pull request found for head SHA '${{ github.event.workflow_run.head_sha }}'.\" >&2\n exit 1\n elif [ \"$PR_COUNT\" -gt 1 ]; then\n echo \"Error: Multiple open pull requests ($PR_COUNT) found for head SHA '${{ github.event.workflow_run.head_sha }}':\" >&2\n printf \"%s\\n\" \"$PR_NUMBERS\" >&2\n exit 1\n fi\n PR_NUMBER=\"$PR_NUMBERS\"\n echo \"number=${PR_NUMBER}\" >> \"$GITHUB_OUTPUT\"\n fi\n env:\n GH_TOKEN: ${{ secrets.GITHUB_TOKEN }}\n\n - name: Upload to Codecov\n uses: codecov/codecov-action@v4\n with:\n token: ${{ secrets.CODECOV_TOKEN }}\n files: ./coverage.xml\n fail_ci_if_error: true\n override_commit: ${{ github.event.workflow_run.head_sha }}\n override_branch: ${{ github.event.workflow_run.head_branch }}\n override_pr: ${{ steps.pr.outputs.number }}\n" }, { "path": ".github/workflows/coverage.yml", "content": "name: Coverage check\non:\n push:\n branches:\n - main\n - current-release\n - \"*LTS\"\n tags:\n - \"!*\" # Do not execute on tags\n pull_request:\n branches:\n - main\n - current-release\n - \"*LTS\"\n\njobs:\n coverage:\n name: Check coverage\n runs-on: ubuntu-latest\n strategy:\n fail-fast: false\n\n steps:\n - name: Run coverage\n uses: sanic-org/simple-tox-action@v1\n with:\n python-version: \"3.11\"\n tox-env: coverage\n ignore-errors: true\n - name: Upload coverage artifact\n uses: actions/upload-artifact@v4\n with:\n name: coverage-report\n path: ./coverage.xml\n retention-days: 1\n if-no-files-found: error\n" }, { "path": ".github/workflows/publish-release.yml", "content": "name: Publish release\n\non:\n release:\n types: [created]\n\nenv:\n IS_TEST: false\n DOCKER_ORG_NAME: sanicframework\n DOCKER_IMAGE_NAME: sanic\n DOCKER_BASE_IMAGE_NAME: sanic-build\n DOCKER_IMAGE_DOCKERFILE: ./docker/Dockerfile\n DOCKER_BASE_IMAGE_DOCKERFILE: ./docker/Dockerfile-base\n\njobs:\n generate_info:\n name: Generate info\n runs-on: ubuntu-latest\n outputs:\n docker-tags: ${{ steps.generate_docker_info.outputs.tags }}\n pypi-version: ${{ steps.parse_version_tag.outputs.pypi-version }}\n is-test: ${{ env.IS_TEST }}\n steps:\n - name: Parse version tag\n id: parse_version_tag\n env:\n TAG_NAME: ${{ github.event.release.tag_name }}\n run: |\n tag_name=\"${{ env.TAG_NAME }}\"\n\n if [[ ! \"${tag_name}\" =~ ^v([0-9]{2})\\.([0-9]{1,2})\\.([0-9]+)$ ]]; then\n echo \"::error::Tag name must be in the format vYY.MM.MICRO\"\n exit 1\n fi\n\n year_output=\"year=${BASH_REMATCH[1]}\"\n month_output=\"month=${BASH_REMATCH[2]}\"\n pypi_output=\"pypi-version=${tag_name#v}\"\n\n echo \"${year_output}\"\n echo \"${month_output}\"\n echo \"${pypi_output}\"\n\n echo \"${year_output}\" >> $GITHUB_OUTPUT\n echo \"${month_output}\" >> $GITHUB_OUTPUT\n echo \"${pypi_output}\" >> $GITHUB_OUTPUT\n\n - name: Get latest release\n id: get_latest_release\n run: |\n latest_tag=$(\n curl -L \\\n -H \"Accept: application/vnd.github+json\" \\\n -H \"Authorization: Bearer ${{ github.token }}\" \\\n -H \"X-GitHub-Api-Version: 2022-11-28\" \\\n https://api.github.com/repos/${{ github.repository }}/releases/latest \\\n | jq -r '.tag_name'\n )\n echo \"latest_tag=$latest_tag\" >> $GITHUB_OUTPUT\n\n - name: Generate Docker info\n id: generate_docker_info\n run: |\n tag_year=\"${{ steps.parse_version_tag.outputs.year }}\"\n tag_month=\"${{ steps.parse_version_tag.outputs.month }}\"\n latest_tag=\"${{ steps.get_latest_release.outputs.latest_tag }}\"\n tag=\"${{ github.event.release.tag_name }}\"\n\n tags=\"${tag_year}.${tag_month}\"\n\n if [[ \"${tag_month}\" == \"12\" ]]; then\n tags+=\",lts\"\n echo \"::notice::Tag ${tag} is LTS version\"\n else\n echo \"::notice::Tag ${tag} is not LTS version\"\n fi\n\n if [[ \"${latest_tag}\" == \"${{ github.event.release.tag_name }}\" ]]; then\n tags+=\",latest\"\n echo \"::notice::Tag ${tag} is marked as latest\"\n else\n echo \"::notice::Tag ${tag} is not marked as latest\"\n fi\n\n tags_output=\"tags=${tags}\"\n\n echo \"${tags_output}\"\n echo \"${tags_output}\" >> $GITHUB_OUTPUT\n\n publish_package:\n name: Build and publish package\n runs-on: ubuntu-latest\n needs: generate_info\n environment: release\n permissions:\n id-token: write\n steps:\n - name: Checkout repo\n uses: actions/checkout@v3\n\n - name: Setup Python\n uses: actions/setup-python@v4\n with:\n python-version: \"3.11\"\n\n - name: Install dependencies\n run: pip install build twine\n\n - name: Update package version\n run: |\n echo \"__version__ = \\\"${{ needs.generate_info.outputs.pypi-version }}\\\"\" > sanic/__version__.py\n\n - name: Build a binary wheel and a source tarball\n run: python -m build --sdist --wheel --outdir dist/ .\n\n - name: Publish package distribution\n uses: pypa/gh-action-pypi-publish@release/v1\n with:\n repository-url: ${{ env.IS_TEST == 'true' && 'https://test.pypi.org/legacy/' || 'https://upload.pypi.org/legacy/' }}\n\n publish_docker:\n name: Publish Docker / Python ${{ matrix.python-version }}\n needs: [generate_info, publish_package]\n runs-on: ubuntu-latest\n if: ${{ needs.generate_info.outputs.is-test == 'false' }}\n strategy:\n fail-fast: true\n matrix:\n python-version: [\"3.10\", \"3.11\"]\n steps:\n - name: Checkout repository\n uses: actions/checkout@v3\n\n - name: Set up Docker Buildx\n uses: docker/setup-buildx-action@v2\n\n - name: Login to Docker Hub\n uses: docker/login-action@v2\n with:\n username: ${{ secrets.DOCKER_ACCESS_USER }}\n password: ${{ secrets.DOCKER_ACCESS_TOKEN }}\n\n - name: Build and push base image\n uses: docker/build-push-action@v4\n with:\n push: ${{ env.IS_TEST == 'false' }}\n file: ${{ env.DOCKER_BASE_IMAGE_DOCKERFILE }}\n tags: ${{ env.DOCKER_ORG_NAME }}/${{ env.DOCKER_BASE_IMAGE_NAME }}:${{ matrix.python-version }}\n build-args: |\n PYTHON_VERSION=${{ matrix.python-version }}\n\n - name: Parse tags for this Python version\n id: parse_tags\n run: |\n IFS=',' read -ra tags <<< \"${{ needs.generate_info.outputs.docker-tags }}\"\n tag_args=\"\"\n\n for tag in \"${tags[@]}\"; do\n tag_args+=\",${{ env.DOCKER_ORG_NAME }}/${{ env.DOCKER_IMAGE_NAME }}:${tag}-py${{ matrix.python-version }}\"\n done\n\n tag_args_output=\"tag_args=${tag_args:1}\"\n\n echo \"${tag_args_output}\"\n echo \"${tag_args_output}\" >> $GITHUB_OUTPUT\n\n - name: Build and push Sanic image\n uses: docker/build-push-action@v4\n with:\n push: ${{ env.IS_TEST == 'false' }}\n file: ${{ env.DOCKER_IMAGE_DOCKERFILE }}\n tags: ${{ steps.parse_tags.outputs.tag_args }}\n build-args: |\n BASE_IMAGE_ORG=${{ env.DOCKER_ORG_NAME }}\n BASE_IMAGE_NAME=${{ env.DOCKER_BASE_IMAGE_NAME }}\n BASE_IMAGE_TAG=${{ matrix.python-version }}\n SANIC_PYPI_VERSION=${{ needs.generate_info.outputs.pypi-version }}\n" }, { "path": ".github/workflows/tests.yml", "content": "name: Tests\n\non:\n push:\n branches:\n - main\n - current-release\n - \"*LTS\"\n tags:\n - \"!*\"\n pull_request:\n branches:\n - main\n - current-release\n - \"*LTS\"\n types: [opened, synchronize, reopened, ready_for_review]\n\njobs:\n run_tests:\n name: \"${{ matrix.config.platform == 'windows-latest' && 'Windows' || 'Linux' }} / Python ${{ matrix.config.python-version }} / tox -e ${{ matrix.config.tox-env }}\"\n if: github.event.pull_request.draft == false\n runs-on: ${{ matrix.config.platform || 'ubuntu-latest' }}\n strategy:\n fail-fast: true\n matrix:\n config:\n - { python-version: \"3.10\", tox-env: security }\n - { python-version: \"3.11\", tox-env: security }\n - { python-version: \"3.12\", tox-env: security }\n - { python-version: \"3.13\", tox-env: security }\n - { python-version: \"3.14\", tox-env: security }\n - { python-version: \"3.14\", tox-env: lint }\n # - { python-version: \"3.10\", tox-env: docs }\n - { python-version: \"3.10\", tox-env: type-checking }\n - { python-version: \"3.11\", tox-env: type-checking }\n - { python-version: \"3.12\", tox-env: type-checking }\n - { python-version: \"3.13\", tox-env: type-checking }\n - { python-version: \"3.14\", tox-env: type-checking }\n - { python-version: \"3.10\", tox-env: py310, max-attempts: 3 }\n - { python-version: \"3.10\", tox-env: py310-no-ext, max-attempts: 3 }\n - { python-version: \"3.11\", tox-env: py311, max-attempts: 3 }\n - { python-version: \"3.11\", tox-env: py311-no-ext, max-attempts: 3 }\n - { python-version: \"3.12\", tox-env: py312, max-attempts: 3 }\n - { python-version: \"3.12\", tox-env: py312-no-ext, max-attempts: 3 }\n - { python-version: \"3.13\", tox-env: py313, max-attempts: 3 }\n - { python-version: \"3.13\", tox-env: py313-no-ext, max-attempts: 3 }\n - { python-version: \"3.14\", tox-env: py314, max-attempts: 3 }\n - { python-version: \"3.14\", tox-env: py314-no-ext, max-attempts: 3 }\n - { python-version: \"3.10\", tox-env: py310-no-ext, platform: windows-latest, ignore-errors: true }\n - { python-version: \"3.11\", tox-env: py311-no-ext, platform: windows-latest, ignore-errors: true }\n steps:\n - name: Run tests\n uses: sanic-org/simple-tox-action@v1\n with:\n python-version: ${{ matrix.config.python-version }}\n tox-env: ${{ matrix.config.tox-env }}\n max-attempts: ${{ matrix.config.max-attempts || 1 }}\n ignore-errors: ${{ matrix.config.ignore-errors || false }}\n" }, { "path": ".gitignore", "content": "*~\n*.egg-info\n*.egg\n*.eggs\n*.pyc\n.coverage\n.coverage.*\ncoverage\ncoverage.xml\n.tox\nsettings.py\n.idea/*\n.cache/*\n.mypy_cache/\n.python-version\ndocs/_build/\ndocs/_api/\nbuild/*\n.DS_Store\ndist/*\npip-wheel-metadata/\n.pytest_cache/*\n.venv/*\nvenv/*\n.vscode/*\nguide/node_modules/\n" }, { "path": "CHANGELOG.md", "content": ".. note::\n\n See https://sanic.dev/en/release-notes/changelog.html\n" }, { "path": "CODE_OF_CONDUCT.md", "content": "# Contributor Covenant Code of Conduct\n\nSee https://sanic.dev/en/organization/code-of-conduct.html\n" }, { "path": "CONTRIBUTING.md", "content": "# Contributing\n\nSee https://sanic.dev/en/organization/contributing.html\n" }, { "path": "LICENSE", "content": "MIT License\n\nCopyright (c) 2016-present Sanic Community\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 all\ncopies 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 THE\nSOFTWARE.\n" }, { "path": "MANIFEST.in", "content": "# Non Code related contents\ninclude LICENSE\ninclude README.rst\ninclude pyproject.toml\n\n# Setup\ninclude setup.py\ninclude Makefile\n\n# Tests\ninclude .coveragerc\ngraft tests\n\nglobal-exclude __pycache__\nglobal-exclude *.py[co]" }, { "path": "Makefile", "content": "RUFF_FORMATTED_FOLDERS = sanic examples scripts tests guide docs\n.DEFAULT: help\n\n.PHONY: help\nhelp:\n\t@echo \"Please use \\`make ' where is one of\"\n\t@echo \"install\"\n\t@echo \"\t\tInstall Sanic\"\n\t@echo \"docker-test\"\n\t@echo \"\t\tRun Sanic Unit Tests using Docker\"\n\t@echo \"fix\"\n\t@echo \"\t\tAnalyze and fix linting issues using ruff\"\n\t@echo \"format\"\n\t@echo \"\t\tAnalyze and format using ruff\"\n\t@echo \"pretty\"\n\t@echo \"\t\tAnalyze and fix linting and format using ruff\"\n\t@echo \"\"\n\t@echo \"docs\"\n\t@echo \"\t\tGenerate Sanic documentation\"\n\t@echo \"\"\n\t@echo \"clean-docs\"\n\t@echo \"\t\tClean Sanic documentation\"\n\t@echo \"\"\n\t@echo \"docs-test\"\n\t@echo \"\t\tTest Sanic Documentation for errors\"\n\t@echo \"\"\n\t@echo \"changelog\"\n\t@echo \"\t\tGenerate changelog for Sanic to prepare for new release\"\n\t@echo \"\"\n\t@echo \"release\"\n\t@echo \"\t\tPrepare Sanic for a new changes by version bump and changelog\"\n\t@echo \"\"\n\n.PHONY: clean\nclean:\n\tfind . ! -path \"./.eggs/*\" -name \"*.pyc\" -exec rm {} \\;\n\tfind . ! -path \"./.eggs/*\" -name \"*.pyo\" -exec rm {} \\;\n\tfind . ! -path \"./.eggs/*\" -name \".coverage\" -exec rm {} \\;\n\trm -rf build/* > /dev/null 2>&1\n\trm -rf dist/* > /dev/null 2>&1\n\n.PHONY: view-coverage\nview-coverage:\n\tsanic ./coverage --simple\n\n.PHONY: install\ninstall:\n\tpython -m pip install .\n\n.PHONY: docker-test\ndocker-test: clean\n\tdocker build -t sanic/test-image -f docker/Dockerfile .\n\tdocker run -t sanic/test-image tox\n\n.PHONY: fix\nfix:\n\truff check ${RUFF_FORMATTED_FOLDERS} --fix\n\n.PHONY: format\nformat:\n\truff format ${RUFF_FORMATTED_FOLDERS}\n\n.PHONY: pretty\npretty: format fix\n\n.PHONY: docs-clean\ndocs-clean:\n\tcd docs && make clean\n\n.PHONY: docs\ndocs: docs-clean\n\tcd docs && make html\n\n.PHONY: docs-test\ndocs-test: docs-clean\n\tcd docs && make dummy\n\n.PHONY: docs-serve\ndocs-serve:\n\tsphinx-autobuild docs docs/_build/html --port 9999 --watch ./\n\n.PHONY: changelog\nchangelog:\n\tpython scripts/changelog.py\n\n.PHONY: guide-serve\nguide-serve:\n\tcd guide && sanic server:app -r -R ./content -R ./style\n\n.PHONY: release\nrelease:\nifdef version\n\tpython scripts/release.py --release-version ${version} --generate-changelog\nelse\n\tpython scripts/release.py --generate-changelog\nendif\n\n" }, { "path": "README.rst", "content": ".. image:: https://raw.githubusercontent.com/sanic-org/sanic-assets/master/png/sanic-framework-logo-400x97.png\n :alt: Sanic | Build fast. Run fast.\n\nSanic | Build fast. Run fast.\n=============================\n\n.. start-badges\n\n.. list-table::\n :widths: 15 85\n :stub-columns: 1\n\n * - Build\n - | |Tests|\n * - Docs\n - | |UserGuide| |Documentation|\n * - Package\n - | |PyPI| |PyPI version| |Wheel| |Supported implementations| |Code style ruff|\n * - Support\n - | |Forums| |Discord| |Awesome|\n * - Stats\n - | |Monthly Downloads| |Weekly Downloads| |Conda downloads|\n\n.. |UserGuide| image:: https://img.shields.io/badge/user%20guide-sanic-ff0068\n :target: https://sanic.dev/\n.. |Forums| image:: https://img.shields.io/badge/forums-community-ff0068.svg\n :target: https://community.sanicframework.org/\n.. |Discord| image:: https://img.shields.io/discord/812221182594121728?logo=discord&label=Discord&color=5865F2\n :target: https://discord.gg/FARQzAEMAA\n.. |Tests| image:: https://github.com/sanic-org/sanic/actions/workflows/tests.yml/badge.svg?branch=main\n :target: https://github.com/sanic-org/sanic/actions/workflows/tests.yml\n.. |Documentation| image:: https://readthedocs.org/projects/sanic/badge/?version=latest\n :target: http://sanic.readthedocs.io/en/latest/?badge=latest\n.. |PyPI| image:: https://img.shields.io/pypi/v/sanic.svg\n :target: https://pypi.python.org/pypi/sanic/\n.. |PyPI version| image:: https://img.shields.io/pypi/pyversions/sanic.svg\n :target: https://pypi.python.org/pypi/sanic/\n.. |Code style ruff| image:: https://img.shields.io/badge/code%20style-ruff-000000.svg\n :target: https://docs.astral.sh/ruff/\n.. |Wheel| image:: https://img.shields.io/pypi/wheel/sanic.svg\n :alt: PyPI Wheel\n :target: https://pypi.python.org/pypi/sanic\n.. |Supported implementations| image:: https://img.shields.io/pypi/implementation/sanic.svg\n :alt: Supported implementations\n :target: https://pypi.python.org/pypi/sanic\n.. |Awesome| image:: https://cdn.rawgit.com/sindresorhus/awesome/d7305f38d29fed78fa85652e3a63e154dd8e8829/media/badge.svg\n :alt: Awesome Sanic List\n :target: https://github.com/mekicha/awesome-sanic\n.. |Monthly Downloads| image:: https://img.shields.io/pypi/dm/sanic.svg\n :alt: Downloads\n :target: https://pepy.tech/project/sanic\n.. |Weekly Downloads| image:: https://img.shields.io/pypi/dw/sanic.svg\n :alt: Downloads\n :target: https://pepy.tech/project/sanic\n.. |Conda downloads| image:: https://img.shields.io/conda/dn/conda-forge/sanic.svg\n :alt: Downloads\n :target: https://anaconda.org/conda-forge/sanic\n\n.. end-badges\n\nSanic is a **Python 3.10+** web server and web framework that's written to go fast. It allows the usage of the ``async/await`` syntax added in Python 3.5, which makes your code non-blocking and speedy.\n\nSanic is also ASGI compliant, so you can deploy it with an `alternative ASGI webserver `_.\n\n`Source code on GitHub `_ | `Help and discussion board `_ | `User Guide `_ | `Chat on Discord `_\n\nThe project is maintained by the community, for the community. **Contributions are welcome!**\n\nThe goal of the project is to provide a simple way to get up and running a highly performant HTTP server that is easy to build, to expand, and ultimately to scale.\n\nSponsor\n-------\n\nCheck out `open collective `_ to learn more about helping to fund Sanic.\n\n\nInstallation\n------------\n\n``pip install sanic``\n\n Sanic makes use of ``uvloop`` and ``ujson`` to help with performance. If you do not want to use those packages, simply add an environmental variable ``SANIC_NO_UVLOOP=true`` or ``SANIC_NO_UJSON=true`` at install time.\n\n .. code:: shell\n\n $ export SANIC_NO_UVLOOP=true\n $ export SANIC_NO_UJSON=true\n $ pip install --no-binary :all: sanic\n\n\n.. note::\n\n If you are running on a clean install of Fedora 28 or above, please make sure you have the ``redhat-rpm-config`` package installed in case if you want to\n use ``sanic`` with ``ujson`` dependency.\n\n\nHello World Example\n-------------------\n\n.. code:: python\n\n from sanic import Sanic\n from sanic.response import json\n\n app = Sanic(\"my-hello-world-app\")\n\n @app.route('/')\n async def test(request):\n return json({'hello': 'world'})\n\nSanic can now be easily run from CLI using ``sanic hello.app``.\n\n.. code::\n\n [2018-12-30 11:37:41 +0200] [13564] [INFO] Goin' Fast @ http://127.0.0.1:8000\n [2018-12-30 11:37:41 +0200] [13564] [INFO] Starting worker [13564]\n\nAnd, we can verify it is working: ``curl localhost:8000 -i``\n\n.. code::\n\n HTTP/1.1 200 OK\n Connection: keep-alive\n Keep-Alive: 5\n Content-Length: 17\n Content-Type: application/json\n\n {\"hello\":\"world\"}\n\n**Now, let's go build something fast!**\n\nMinimum Python version is 3.10.\n\nDocumentation\n-------------\n\nUser Guide, Changelog, and API Documentation can be found at `sanic.dev `__.\n\n\nQuestions and Discussion\n------------------------\n\n`Ask a question or join the conversation `__.\n\nContribution\n------------\n\nWe are always happy to have new contributions. We have `marked issues good for anyone looking to get started `_, and welcome `questions on the forums `_. Please take a look at our `Contribution guidelines `_.\n" }, { "path": "SECURITY.md", "content": "# Security Policy\n\nSee https://sanic.dev/en/organization/policies.html\n" }, { "path": "bandit.baseline", "content": "{\n \"errors\": [],\n \"generated_at\": \"2025-09-14T20:47:44Z\",\n \"metrics\": {\n \"_totals\": {\n \"CONFIDENCE.HIGH\": 10,\n \"CONFIDENCE.LOW\": 0,\n \"CONFIDENCE.MEDIUM\": 0,\n \"CONFIDENCE.UNDEFINED\": 0,\n \"SEVERITY.HIGH\": 0,\n \"SEVERITY.LOW\": 10,\n \"SEVERITY.MEDIUM\": 0,\n \"SEVERITY.UNDEFINED\": 0,\n \"loc\": 20091,\n \"nosec\": 2,\n \"skipped_tests\": 6\n },\n \"sanic/__init__.py\": {\n \"CONFIDENCE.HIGH\": 0,\n \"CONFIDENCE.LOW\": 0,\n \"CONFIDENCE.MEDIUM\": 0,\n \"CONFIDENCE.UNDEFINED\": 0,\n \"SEVERITY.HIGH\": 0,\n \"SEVERITY.LOW\": 0,\n \"SEVERITY.MEDIUM\": 0,\n \"SEVERITY.UNDEFINED\": 0,\n \"loc\": 76,\n \"nosec\": 0,\n \"skipped_tests\": 0\n },\n \"sanic/__main__.py\": {\n \"CONFIDENCE.HIGH\": 0,\n \"CONFIDENCE.LOW\": 0,\n \"CONFIDENCE.MEDIUM\": 0,\n \"CONFIDENCE.UNDEFINED\": 0,\n \"SEVERITY.HIGH\": 0,\n \"SEVERITY.LOW\": 0,\n \"SEVERITY.MEDIUM\": 0,\n \"SEVERITY.UNDEFINED\": 0,\n \"loc\": 10,\n \"nosec\": 0,\n \"skipped_tests\": 0\n },\n \"sanic/__version__.py\": {\n \"CONFIDENCE.HIGH\": 0,\n \"CONFIDENCE.LOW\": 0,\n \"CONFIDENCE.MEDIUM\": 0,\n \"CONFIDENCE.UNDEFINED\": 0,\n \"SEVERITY.HIGH\": 0,\n \"SEVERITY.LOW\": 0,\n \"SEVERITY.MEDIUM\": 0,\n \"SEVERITY.UNDEFINED\": 0,\n \"loc\": 1,\n \"nosec\": 0,\n \"skipped_tests\": 0\n },\n \"sanic/app.py\": {\n \"CONFIDENCE.HIGH\": 1,\n \"CONFIDENCE.LOW\": 0,\n \"CONFIDENCE.MEDIUM\": 0,\n \"CONFIDENCE.UNDEFINED\": 0,\n \"SEVERITY.HIGH\": 0,\n \"SEVERITY.LOW\": 1,\n \"SEVERITY.MEDIUM\": 0,\n \"SEVERITY.UNDEFINED\": 0,\n \"loc\": 2122,\n \"nosec\": 0,\n \"skipped_tests\": 0\n },\n \"sanic/application/__init__.py\": {\n \"CONFIDENCE.HIGH\": 0,\n \"CONFIDENCE.LOW\": 0,\n \"CONFIDENCE.MEDIUM\": 0,\n \"CONFIDENCE.UNDEFINED\": 0,\n \"SEVERITY.HIGH\": 0,\n \"SEVERITY.LOW\": 0,\n \"SEVERITY.MEDIUM\": 0,\n \"SEVERITY.UNDEFINED\": 0,\n \"loc\": 0,\n \"nosec\": 0,\n \"skipped_tests\": 0\n },\n \"sanic/application/constants.py\": {\n \"CONFIDENCE.HIGH\": 0,\n \"CONFIDENCE.LOW\": 0,\n \"CONFIDENCE.MEDIUM\": 0,\n \"CONFIDENCE.UNDEFINED\": 0,\n \"SEVERITY.HIGH\": 0,\n \"SEVERITY.LOW\": 0,\n \"SEVERITY.MEDIUM\": 0,\n \"SEVERITY.UNDEFINED\": 0,\n \"loc\": 24,\n \"nosec\": 0,\n \"skipped_tests\": 0\n },\n \"sanic/application/ext.py\": {\n \"CONFIDENCE.HIGH\": 0,\n \"CONFIDENCE.LOW\": 0,\n \"CONFIDENCE.MEDIUM\": 0,\n \"CONFIDENCE.UNDEFINED\": 0,\n \"SEVERITY.HIGH\": 0,\n \"SEVERITY.LOW\": 0,\n \"SEVERITY.MEDIUM\": 0,\n \"SEVERITY.UNDEFINED\": 0,\n \"loc\": 34,\n \"nosec\": 0,\n \"skipped_tests\": 0\n },\n \"sanic/application/logo.py\": {\n \"CONFIDENCE.HIGH\": 0,\n \"CONFIDENCE.LOW\": 0,\n \"CONFIDENCE.MEDIUM\": 0,\n \"CONFIDENCE.UNDEFINED\": 0,\n \"SEVERITY.HIGH\": 0,\n \"SEVERITY.LOW\": 0,\n \"SEVERITY.MEDIUM\": 0,\n \"SEVERITY.UNDEFINED\": 0,\n \"loc\": 53,\n \"nosec\": 0,\n \"skipped_tests\": 0\n },\n \"sanic/application/motd.py\": {\n \"CONFIDENCE.HIGH\": 0,\n \"CONFIDENCE.LOW\": 0,\n \"CONFIDENCE.MEDIUM\": 0,\n \"CONFIDENCE.UNDEFINED\": 0,\n \"SEVERITY.HIGH\": 0,\n \"SEVERITY.LOW\": 0,\n \"SEVERITY.MEDIUM\": 0,\n \"SEVERITY.UNDEFINED\": 0,\n \"loc\": 155,\n \"nosec\": 0,\n \"skipped_tests\": 0\n },\n \"sanic/application/spinner.py\": {\n \"CONFIDENCE.HIGH\": 0,\n \"CONFIDENCE.LOW\": 0,\n \"CONFIDENCE.MEDIUM\": 0,\n \"CONFIDENCE.UNDEFINED\": 0,\n \"SEVERITY.HIGH\": 0,\n \"SEVERITY.LOW\": 0,\n \"SEVERITY.MEDIUM\": 0,\n \"SEVERITY.UNDEFINED\": 0,\n \"loc\": 74,\n \"nosec\": 0,\n \"skipped_tests\": 0\n },\n \"sanic/application/state.py\": {\n \"CONFIDENCE.HIGH\": 0,\n \"CONFIDENCE.LOW\": 0,\n \"CONFIDENCE.MEDIUM\": 0,\n \"CONFIDENCE.UNDEFINED\": 0,\n \"SEVERITY.HIGH\": 0,\n \"SEVERITY.LOW\": 0,\n \"SEVERITY.MEDIUM\": 0,\n \"SEVERITY.UNDEFINED\": 0,\n \"loc\": 89,\n \"nosec\": 0,\n \"skipped_tests\": 0\n },\n \"sanic/asgi.py\": {\n \"CONFIDENCE.HIGH\": 0,\n \"CONFIDENCE.LOW\": 0,\n \"CONFIDENCE.MEDIUM\": 0,\n \"CONFIDENCE.UNDEFINED\": 0,\n \"SEVERITY.HIGH\": 0,\n \"SEVERITY.LOW\": 0,\n \"SEVERITY.MEDIUM\": 0,\n \"SEVERITY.UNDEFINED\": 0,\n \"loc\": 233,\n \"nosec\": 0,\n \"skipped_tests\": 0\n },\n \"sanic/base/__init__.py\": {\n \"CONFIDENCE.HIGH\": 0,\n \"CONFIDENCE.LOW\": 0,\n \"CONFIDENCE.MEDIUM\": 0,\n \"CONFIDENCE.UNDEFINED\": 0,\n \"SEVERITY.HIGH\": 0,\n \"SEVERITY.LOW\": 0,\n \"SEVERITY.MEDIUM\": 0,\n \"SEVERITY.UNDEFINED\": 0,\n \"loc\": 0,\n \"nosec\": 0,\n \"skipped_tests\": 0\n },\n \"sanic/base/meta.py\": {\n \"CONFIDENCE.HIGH\": 0,\n \"CONFIDENCE.LOW\": 0,\n \"CONFIDENCE.MEDIUM\": 0,\n \"CONFIDENCE.UNDEFINED\": 0,\n \"SEVERITY.HIGH\": 0,\n \"SEVERITY.LOW\": 0,\n \"SEVERITY.MEDIUM\": 0,\n \"SEVERITY.UNDEFINED\": 0,\n \"loc\": 6,\n \"nosec\": 0,\n \"skipped_tests\": 0\n },\n \"sanic/base/root.py\": {\n \"CONFIDENCE.HIGH\": 0,\n \"CONFIDENCE.LOW\": 0,\n \"CONFIDENCE.MEDIUM\": 0,\n \"CONFIDENCE.UNDEFINED\": 0,\n \"SEVERITY.HIGH\": 0,\n \"SEVERITY.LOW\": 0,\n \"SEVERITY.MEDIUM\": 0,\n \"SEVERITY.UNDEFINED\": 0,\n \"loc\": 55,\n \"nosec\": 0,\n \"skipped_tests\": 0\n },\n \"sanic/blueprint_group.py\": {\n \"CONFIDENCE.HIGH\": 0,\n \"CONFIDENCE.LOW\": 0,\n \"CONFIDENCE.MEDIUM\": 0,\n \"CONFIDENCE.UNDEFINED\": 0,\n \"SEVERITY.HIGH\": 0,\n \"SEVERITY.LOW\": 0,\n \"SEVERITY.MEDIUM\": 0,\n \"SEVERITY.UNDEFINED\": 0,\n \"loc\": 2,\n \"nosec\": 0,\n \"skipped_tests\": 0\n },\n \"sanic/blueprints.py\": {\n \"CONFIDENCE.HIGH\": 0,\n \"CONFIDENCE.LOW\": 0,\n \"CONFIDENCE.MEDIUM\": 0,\n \"CONFIDENCE.UNDEFINED\": 0,\n \"SEVERITY.HIGH\": 0,\n \"SEVERITY.LOW\": 0,\n \"SEVERITY.MEDIUM\": 0,\n \"SEVERITY.UNDEFINED\": 0,\n \"loc\": 790,\n \"nosec\": 0,\n \"skipped_tests\": 0\n },\n \"sanic/cli/__init__.py\": {\n \"CONFIDENCE.HIGH\": 0,\n \"CONFIDENCE.LOW\": 0,\n \"CONFIDENCE.MEDIUM\": 0,\n \"CONFIDENCE.UNDEFINED\": 0,\n \"SEVERITY.HIGH\": 0,\n \"SEVERITY.LOW\": 0,\n \"SEVERITY.MEDIUM\": 0,\n \"SEVERITY.UNDEFINED\": 0,\n \"loc\": 0,\n \"nosec\": 0,\n \"skipped_tests\": 0\n },\n \"sanic/cli/app.py\": {\n \"CONFIDENCE.HIGH\": 0,\n \"CONFIDENCE.LOW\": 0,\n \"CONFIDENCE.MEDIUM\": 0,\n \"CONFIDENCE.UNDEFINED\": 0,\n \"SEVERITY.HIGH\": 0,\n \"SEVERITY.LOW\": 0,\n \"SEVERITY.MEDIUM\": 0,\n \"SEVERITY.UNDEFINED\": 0,\n \"loc\": 239,\n \"nosec\": 0,\n \"skipped_tests\": 0\n },\n \"sanic/cli/arguments.py\": {\n \"CONFIDENCE.HIGH\": 0,\n \"CONFIDENCE.LOW\": 0,\n \"CONFIDENCE.MEDIUM\": 0,\n \"CONFIDENCE.UNDEFINED\": 0,\n \"SEVERITY.HIGH\": 0,\n \"SEVERITY.LOW\": 0,\n \"SEVERITY.MEDIUM\": 0,\n \"SEVERITY.UNDEFINED\": 0,\n \"loc\": 283,\n \"nosec\": 0,\n \"skipped_tests\": 0\n },\n \"sanic/cli/base.py\": {\n \"CONFIDENCE.HIGH\": 0,\n \"CONFIDENCE.LOW\": 0,\n \"CONFIDENCE.MEDIUM\": 0,\n \"CONFIDENCE.UNDEFINED\": 0,\n \"SEVERITY.HIGH\": 0,\n \"SEVERITY.LOW\": 0,\n \"SEVERITY.MEDIUM\": 0,\n \"SEVERITY.UNDEFINED\": 0,\n \"loc\": 27,\n \"nosec\": 0,\n \"skipped_tests\": 0\n },\n \"sanic/cli/console.py\": {\n \"CONFIDENCE.HIGH\": 3,\n \"CONFIDENCE.LOW\": 0,\n \"CONFIDENCE.MEDIUM\": 0,\n \"CONFIDENCE.UNDEFINED\": 0,\n \"SEVERITY.HIGH\": 0,\n \"SEVERITY.LOW\": 3,\n \"SEVERITY.MEDIUM\": 0,\n \"SEVERITY.UNDEFINED\": 0,\n \"loc\": 242,\n \"nosec\": 0,\n \"skipped_tests\": 0\n },\n \"sanic/cli/executor.py\": {\n \"CONFIDENCE.HIGH\": 0,\n \"CONFIDENCE.LOW\": 0,\n \"CONFIDENCE.MEDIUM\": 0,\n \"CONFIDENCE.UNDEFINED\": 0,\n \"SEVERITY.HIGH\": 0,\n \"SEVERITY.LOW\": 0,\n \"SEVERITY.MEDIUM\": 0,\n \"SEVERITY.UNDEFINED\": 0,\n \"loc\": 76,\n \"nosec\": 0,\n \"skipped_tests\": 0\n },\n \"sanic/cli/inspector.py\": {\n \"CONFIDENCE.HIGH\": 0,\n \"CONFIDENCE.LOW\": 0,\n \"CONFIDENCE.MEDIUM\": 0,\n \"CONFIDENCE.UNDEFINED\": 0,\n \"SEVERITY.HIGH\": 0,\n \"SEVERITY.LOW\": 0,\n \"SEVERITY.MEDIUM\": 0,\n \"SEVERITY.UNDEFINED\": 0,\n \"loc\": 97,\n \"nosec\": 0,\n \"skipped_tests\": 0\n },\n \"sanic/cli/inspector_client.py\": {\n \"CONFIDENCE.HIGH\": 0,\n \"CONFIDENCE.LOW\": 0,\n \"CONFIDENCE.MEDIUM\": 0,\n \"CONFIDENCE.UNDEFINED\": 0,\n \"SEVERITY.HIGH\": 0,\n \"SEVERITY.LOW\": 0,\n \"SEVERITY.MEDIUM\": 0,\n \"SEVERITY.UNDEFINED\": 0,\n \"loc\": 106,\n \"nosec\": 0,\n \"skipped_tests\": 1\n },\n \"sanic/compat.py\": {\n \"CONFIDENCE.HIGH\": 0,\n \"CONFIDENCE.LOW\": 0,\n \"CONFIDENCE.MEDIUM\": 0,\n \"CONFIDENCE.UNDEFINED\": 0,\n \"SEVERITY.HIGH\": 0,\n \"SEVERITY.LOW\": 0,\n \"SEVERITY.MEDIUM\": 0,\n \"SEVERITY.UNDEFINED\": 0,\n \"loc\": 126,\n \"nosec\": 0,\n \"skipped_tests\": 0\n },\n \"sanic/config.py\": {\n \"CONFIDENCE.HIGH\": 0,\n \"CONFIDENCE.LOW\": 0,\n \"CONFIDENCE.MEDIUM\": 0,\n \"CONFIDENCE.UNDEFINED\": 0,\n \"SEVERITY.HIGH\": 0,\n \"SEVERITY.LOW\": 0,\n \"SEVERITY.MEDIUM\": 0,\n \"SEVERITY.UNDEFINED\": 0,\n \"loc\": 350,\n \"nosec\": 0,\n \"skipped_tests\": 0\n },\n \"sanic/constants.py\": {\n \"CONFIDENCE.HIGH\": 0,\n \"CONFIDENCE.LOW\": 0,\n \"CONFIDENCE.MEDIUM\": 0,\n \"CONFIDENCE.UNDEFINED\": 0,\n \"SEVERITY.HIGH\": 0,\n \"SEVERITY.LOW\": 0,\n \"SEVERITY.MEDIUM\": 0,\n \"SEVERITY.UNDEFINED\": 0,\n \"loc\": 29,\n \"nosec\": 0,\n \"skipped_tests\": 0\n },\n \"sanic/cookies/__init__.py\": {\n \"CONFIDENCE.HIGH\": 0,\n \"CONFIDENCE.LOW\": 0,\n \"CONFIDENCE.MEDIUM\": 0,\n \"CONFIDENCE.UNDEFINED\": 0,\n \"SEVERITY.HIGH\": 0,\n \"SEVERITY.LOW\": 0,\n \"SEVERITY.MEDIUM\": 0,\n \"SEVERITY.UNDEFINED\": 0,\n \"loc\": 2,\n \"nosec\": 0,\n \"skipped_tests\": 0\n },\n \"sanic/cookies/request.py\": {\n \"CONFIDENCE.HIGH\": 0,\n \"CONFIDENCE.LOW\": 0,\n \"CONFIDENCE.MEDIUM\": 0,\n \"CONFIDENCE.UNDEFINED\": 0,\n \"SEVERITY.HIGH\": 0,\n \"SEVERITY.LOW\": 0,\n \"SEVERITY.MEDIUM\": 0,\n \"SEVERITY.UNDEFINED\": 0,\n \"loc\": 122,\n \"nosec\": 0,\n \"skipped_tests\": 0\n },\n \"sanic/cookies/response.py\": {\n \"CONFIDENCE.HIGH\": 0,\n \"CONFIDENCE.LOW\": 0,\n \"CONFIDENCE.MEDIUM\": 0,\n \"CONFIDENCE.UNDEFINED\": 0,\n \"SEVERITY.HIGH\": 0,\n \"SEVERITY.LOW\": 0,\n \"SEVERITY.MEDIUM\": 0,\n \"SEVERITY.UNDEFINED\": 0,\n \"loc\": 521,\n \"nosec\": 0,\n \"skipped_tests\": 0\n },\n \"sanic/errorpages.py\": {\n \"CONFIDENCE.HIGH\": 0,\n \"CONFIDENCE.LOW\": 0,\n \"CONFIDENCE.MEDIUM\": 0,\n \"CONFIDENCE.UNDEFINED\": 0,\n \"SEVERITY.HIGH\": 0,\n \"SEVERITY.LOW\": 0,\n \"SEVERITY.MEDIUM\": 0,\n \"SEVERITY.UNDEFINED\": 0,\n \"loc\": 321,\n \"nosec\": 0,\n \"skipped_tests\": 0\n },\n \"sanic/exceptions.py\": {\n \"CONFIDENCE.HIGH\": 0,\n \"CONFIDENCE.LOW\": 0,\n \"CONFIDENCE.MEDIUM\": 0,\n \"CONFIDENCE.UNDEFINED\": 0,\n \"SEVERITY.HIGH\": 0,\n \"SEVERITY.LOW\": 0,\n \"SEVERITY.MEDIUM\": 0,\n \"SEVERITY.UNDEFINED\": 0,\n \"loc\": 538,\n \"nosec\": 0,\n \"skipped_tests\": 0\n },\n \"sanic/handlers/__init__.py\": {\n \"CONFIDENCE.HIGH\": 0,\n \"CONFIDENCE.LOW\": 0,\n \"CONFIDENCE.MEDIUM\": 0,\n \"CONFIDENCE.UNDEFINED\": 0,\n \"SEVERITY.HIGH\": 0,\n \"SEVERITY.LOW\": 0,\n \"SEVERITY.MEDIUM\": 0,\n \"SEVERITY.UNDEFINED\": 0,\n \"loc\": 8,\n \"nosec\": 0,\n \"skipped_tests\": 0\n },\n \"sanic/handlers/content_range.py\": {\n \"CONFIDENCE.HIGH\": 0,\n \"CONFIDENCE.LOW\": 0,\n \"CONFIDENCE.MEDIUM\": 0,\n \"CONFIDENCE.UNDEFINED\": 0,\n \"SEVERITY.HIGH\": 0,\n \"SEVERITY.LOW\": 0,\n \"SEVERITY.MEDIUM\": 0,\n \"SEVERITY.UNDEFINED\": 0,\n \"loc\": 63,\n \"nosec\": 0,\n \"skipped_tests\": 0\n },\n \"sanic/handlers/directory.py\": {\n \"CONFIDENCE.HIGH\": 0,\n \"CONFIDENCE.LOW\": 0,\n \"CONFIDENCE.MEDIUM\": 0,\n \"CONFIDENCE.UNDEFINED\": 0,\n \"SEVERITY.HIGH\": 0,\n \"SEVERITY.LOW\": 0,\n \"SEVERITY.MEDIUM\": 0,\n \"SEVERITY.UNDEFINED\": 0,\n \"loc\": 89,\n \"nosec\": 0,\n \"skipped_tests\": 0\n },\n \"sanic/handlers/error.py\": {\n \"CONFIDENCE.HIGH\": 0,\n \"CONFIDENCE.LOW\": 0,\n \"CONFIDENCE.MEDIUM\": 0,\n \"CONFIDENCE.UNDEFINED\": 0,\n \"SEVERITY.HIGH\": 0,\n \"SEVERITY.LOW\": 0,\n \"SEVERITY.MEDIUM\": 0,\n \"SEVERITY.UNDEFINED\": 0,\n \"loc\": 166,\n \"nosec\": 0,\n \"skipped_tests\": 0\n },\n \"sanic/headers.py\": {\n \"CONFIDENCE.HIGH\": 1,\n \"CONFIDENCE.LOW\": 0,\n \"CONFIDENCE.MEDIUM\": 0,\n \"CONFIDENCE.UNDEFINED\": 0,\n \"SEVERITY.HIGH\": 0,\n \"SEVERITY.LOW\": 1,\n \"SEVERITY.MEDIUM\": 0,\n \"SEVERITY.UNDEFINED\": 0,\n \"loc\": 421,\n \"nosec\": 0,\n \"skipped_tests\": 0\n },\n \"sanic/helpers.py\": {\n \"CONFIDENCE.HIGH\": 0,\n \"CONFIDENCE.LOW\": 0,\n \"CONFIDENCE.MEDIUM\": 0,\n \"CONFIDENCE.UNDEFINED\": 0,\n \"SEVERITY.HIGH\": 0,\n \"SEVERITY.LOW\": 0,\n \"SEVERITY.MEDIUM\": 0,\n \"SEVERITY.UNDEFINED\": 0,\n \"loc\": 142,\n \"nosec\": 0,\n \"skipped_tests\": 0\n },\n \"sanic/http/__init__.py\": {\n \"CONFIDENCE.HIGH\": 0,\n \"CONFIDENCE.LOW\": 0,\n \"CONFIDENCE.MEDIUM\": 0,\n \"CONFIDENCE.UNDEFINED\": 0,\n \"SEVERITY.HIGH\": 0,\n \"SEVERITY.LOW\": 0,\n \"SEVERITY.MEDIUM\": 0,\n \"SEVERITY.UNDEFINED\": 0,\n \"loc\": 4,\n \"nosec\": 0,\n \"skipped_tests\": 0\n },\n \"sanic/http/constants.py\": {\n \"CONFIDENCE.HIGH\": 0,\n \"CONFIDENCE.LOW\": 0,\n \"CONFIDENCE.MEDIUM\": 0,\n \"CONFIDENCE.UNDEFINED\": 0,\n \"SEVERITY.HIGH\": 0,\n \"SEVERITY.LOW\": 0,\n \"SEVERITY.MEDIUM\": 0,\n \"SEVERITY.UNDEFINED\": 0,\n \"loc\": 22,\n \"nosec\": 0,\n \"skipped_tests\": 0\n },\n \"sanic/http/http1.py\": {\n \"CONFIDENCE.HIGH\": 0,\n \"CONFIDENCE.LOW\": 0,\n \"CONFIDENCE.MEDIUM\": 0,\n \"CONFIDENCE.UNDEFINED\": 0,\n \"SEVERITY.HIGH\": 0,\n \"SEVERITY.LOW\": 0,\n \"SEVERITY.MEDIUM\": 0,\n \"SEVERITY.UNDEFINED\": 0,\n \"loc\": 470,\n \"nosec\": 0,\n \"skipped_tests\": 0\n },\n \"sanic/http/http3.py\": {\n \"CONFIDENCE.HIGH\": 0,\n \"CONFIDENCE.LOW\": 0,\n \"CONFIDENCE.MEDIUM\": 0,\n \"CONFIDENCE.UNDEFINED\": 0,\n \"SEVERITY.HIGH\": 0,\n \"SEVERITY.LOW\": 0,\n \"SEVERITY.MEDIUM\": 0,\n \"SEVERITY.UNDEFINED\": 0,\n \"loc\": 348,\n \"nosec\": 0,\n \"skipped_tests\": 0\n },\n \"sanic/http/stream.py\": {\n \"CONFIDENCE.HIGH\": 0,\n \"CONFIDENCE.LOW\": 0,\n \"CONFIDENCE.MEDIUM\": 0,\n \"CONFIDENCE.UNDEFINED\": 0,\n \"SEVERITY.HIGH\": 0,\n \"SEVERITY.LOW\": 0,\n \"SEVERITY.MEDIUM\": 0,\n \"SEVERITY.UNDEFINED\": 0,\n \"loc\": 19,\n \"nosec\": 0,\n \"skipped_tests\": 0\n },\n \"sanic/http/tls/__init__.py\": {\n \"CONFIDENCE.HIGH\": 0,\n \"CONFIDENCE.LOW\": 0,\n \"CONFIDENCE.MEDIUM\": 0,\n \"CONFIDENCE.UNDEFINED\": 0,\n \"SEVERITY.HIGH\": 0,\n \"SEVERITY.LOW\": 0,\n \"SEVERITY.MEDIUM\": 0,\n \"SEVERITY.UNDEFINED\": 0,\n \"loc\": 3,\n \"nosec\": 0,\n \"skipped_tests\": 0\n },\n \"sanic/http/tls/context.py\": {\n \"CONFIDENCE.HIGH\": 0,\n \"CONFIDENCE.LOW\": 0,\n \"CONFIDENCE.MEDIUM\": 0,\n \"CONFIDENCE.UNDEFINED\": 0,\n \"SEVERITY.HIGH\": 0,\n \"SEVERITY.LOW\": 0,\n \"SEVERITY.MEDIUM\": 0,\n \"SEVERITY.UNDEFINED\": 0,\n \"loc\": 169,\n \"nosec\": 0,\n \"skipped_tests\": 0\n },\n \"sanic/http/tls/creators.py\": {\n \"CONFIDENCE.HIGH\": 1,\n \"CONFIDENCE.LOW\": 0,\n \"CONFIDENCE.MEDIUM\": 0,\n \"CONFIDENCE.UNDEFINED\": 0,\n \"SEVERITY.HIGH\": 0,\n \"SEVERITY.LOW\": 1,\n \"SEVERITY.MEDIUM\": 0,\n \"SEVERITY.UNDEFINED\": 0,\n \"loc\": 245,\n \"nosec\": 0,\n \"skipped_tests\": 3\n },\n \"sanic/log.py\": {\n \"CONFIDENCE.HIGH\": 0,\n \"CONFIDENCE.LOW\": 0,\n \"CONFIDENCE.MEDIUM\": 0,\n \"CONFIDENCE.UNDEFINED\": 0,\n \"SEVERITY.HIGH\": 0,\n \"SEVERITY.LOW\": 0,\n \"SEVERITY.MEDIUM\": 0,\n \"SEVERITY.UNDEFINED\": 0,\n \"loc\": 22,\n \"nosec\": 0,\n \"skipped_tests\": 0\n },\n \"sanic/logging/__init__.py\": {\n \"CONFIDENCE.HIGH\": 0,\n \"CONFIDENCE.LOW\": 0,\n \"CONFIDENCE.MEDIUM\": 0,\n \"CONFIDENCE.UNDEFINED\": 0,\n \"SEVERITY.HIGH\": 0,\n \"SEVERITY.LOW\": 0,\n \"SEVERITY.MEDIUM\": 0,\n \"SEVERITY.UNDEFINED\": 0,\n \"loc\": 0,\n \"nosec\": 0,\n \"skipped_tests\": 0\n },\n \"sanic/logging/color.py\": {\n \"CONFIDENCE.HIGH\": 0,\n \"CONFIDENCE.LOW\": 0,\n \"CONFIDENCE.MEDIUM\": 0,\n \"CONFIDENCE.UNDEFINED\": 0,\n \"SEVERITY.HIGH\": 0,\n \"SEVERITY.LOW\": 0,\n \"SEVERITY.MEDIUM\": 0,\n \"SEVERITY.UNDEFINED\": 0,\n \"loc\": 48,\n \"nosec\": 0,\n \"skipped_tests\": 0\n },\n \"sanic/logging/default.py\": {\n \"CONFIDENCE.HIGH\": 0,\n \"CONFIDENCE.LOW\": 0,\n \"CONFIDENCE.MEDIUM\": 0,\n \"CONFIDENCE.UNDEFINED\": 0,\n \"SEVERITY.HIGH\": 0,\n \"SEVERITY.LOW\": 0,\n \"SEVERITY.MEDIUM\": 0,\n \"SEVERITY.UNDEFINED\": 0,\n \"loc\": 57,\n \"nosec\": 0,\n \"skipped_tests\": 0\n },\n \"sanic/logging/deprecation.py\": {\n \"CONFIDENCE.HIGH\": 0,\n \"CONFIDENCE.LOW\": 0,\n \"CONFIDENCE.MEDIUM\": 0,\n \"CONFIDENCE.UNDEFINED\": 0,\n \"SEVERITY.HIGH\": 0,\n \"SEVERITY.LOW\": 0,\n \"SEVERITY.MEDIUM\": 0,\n \"SEVERITY.UNDEFINED\": 0,\n \"loc\": 23,\n \"nosec\": 0,\n \"skipped_tests\": 0\n },\n \"sanic/logging/filter.py\": {\n \"CONFIDENCE.HIGH\": 0,\n \"CONFIDENCE.LOW\": 0,\n \"CONFIDENCE.MEDIUM\": 0,\n \"CONFIDENCE.UNDEFINED\": 0,\n \"SEVERITY.HIGH\": 0,\n \"SEVERITY.LOW\": 0,\n \"SEVERITY.MEDIUM\": 0,\n \"SEVERITY.UNDEFINED\": 0,\n \"loc\": 9,\n \"nosec\": 0,\n \"skipped_tests\": 0\n },\n \"sanic/logging/formatter.py\": {\n \"CONFIDENCE.HIGH\": 0,\n \"CONFIDENCE.LOW\": 0,\n \"CONFIDENCE.MEDIUM\": 0,\n \"CONFIDENCE.UNDEFINED\": 0,\n \"SEVERITY.HIGH\": 0,\n \"SEVERITY.LOW\": 0,\n \"SEVERITY.MEDIUM\": 0,\n \"SEVERITY.UNDEFINED\": 0,\n \"loc\": 315,\n \"nosec\": 0,\n \"skipped_tests\": 0\n },\n \"sanic/logging/loggers.py\": {\n \"CONFIDENCE.HIGH\": 0,\n \"CONFIDENCE.LOW\": 0,\n \"CONFIDENCE.MEDIUM\": 0,\n \"CONFIDENCE.UNDEFINED\": 0,\n \"SEVERITY.HIGH\": 0,\n \"SEVERITY.LOW\": 0,\n \"SEVERITY.MEDIUM\": 0,\n \"SEVERITY.UNDEFINED\": 0,\n \"loc\": 29,\n \"nosec\": 0,\n \"skipped_tests\": 0\n },\n \"sanic/logging/setup.py\": {\n \"CONFIDENCE.HIGH\": 0,\n \"CONFIDENCE.LOW\": 0,\n \"CONFIDENCE.MEDIUM\": 0,\n \"CONFIDENCE.UNDEFINED\": 0,\n \"SEVERITY.HIGH\": 0,\n \"SEVERITY.LOW\": 0,\n \"SEVERITY.MEDIUM\": 0,\n \"SEVERITY.UNDEFINED\": 0,\n \"loc\": 53,\n \"nosec\": 0,\n \"skipped_tests\": 0\n },\n \"sanic/middleware.py\": {\n \"CONFIDENCE.HIGH\": 0,\n \"CONFIDENCE.LOW\": 0,\n \"CONFIDENCE.MEDIUM\": 0,\n \"CONFIDENCE.UNDEFINED\": 0,\n \"SEVERITY.HIGH\": 0,\n \"SEVERITY.LOW\": 0,\n \"SEVERITY.MEDIUM\": 0,\n \"SEVERITY.UNDEFINED\": 0,\n \"loc\": 83,\n \"nosec\": 0,\n \"skipped_tests\": 0\n },\n \"sanic/mixins/__init__.py\": {\n \"CONFIDENCE.HIGH\": 0,\n \"CONFIDENCE.LOW\": 0,\n \"CONFIDENCE.MEDIUM\": 0,\n \"CONFIDENCE.UNDEFINED\": 0,\n \"SEVERITY.HIGH\": 0,\n \"SEVERITY.LOW\": 0,\n \"SEVERITY.MEDIUM\": 0,\n \"SEVERITY.UNDEFINED\": 0,\n \"loc\": 0,\n \"nosec\": 0,\n \"skipped_tests\": 0\n },\n \"sanic/mixins/base.py\": {\n \"CONFIDENCE.HIGH\": 0,\n \"CONFIDENCE.LOW\": 0,\n \"CONFIDENCE.MEDIUM\": 0,\n \"CONFIDENCE.UNDEFINED\": 0,\n \"SEVERITY.HIGH\": 0,\n \"SEVERITY.LOW\": 0,\n \"SEVERITY.MEDIUM\": 0,\n \"SEVERITY.UNDEFINED\": 0,\n \"loc\": 30,\n \"nosec\": 0,\n \"skipped_tests\": 0\n },\n \"sanic/mixins/commands.py\": {\n \"CONFIDENCE.HIGH\": 0,\n \"CONFIDENCE.LOW\": 0,\n \"CONFIDENCE.MEDIUM\": 0,\n \"CONFIDENCE.UNDEFINED\": 0,\n \"SEVERITY.HIGH\": 0,\n \"SEVERITY.LOW\": 0,\n \"SEVERITY.MEDIUM\": 0,\n \"SEVERITY.UNDEFINED\": 0,\n \"loc\": 24,\n \"nosec\": 0,\n \"skipped_tests\": 0\n },\n \"sanic/mixins/exceptions.py\": {\n \"CONFIDENCE.HIGH\": 0,\n \"CONFIDENCE.LOW\": 0,\n \"CONFIDENCE.MEDIUM\": 0,\n \"CONFIDENCE.UNDEFINED\": 0,\n \"SEVERITY.HIGH\": 0,\n \"SEVERITY.LOW\": 0,\n \"SEVERITY.MEDIUM\": 0,\n \"SEVERITY.UNDEFINED\": 0,\n \"loc\": 81,\n \"nosec\": 0,\n \"skipped_tests\": 0\n },\n \"sanic/mixins/listeners.py\": {\n \"CONFIDENCE.HIGH\": 0,\n \"CONFIDENCE.LOW\": 0,\n \"CONFIDENCE.MEDIUM\": 0,\n \"CONFIDENCE.UNDEFINED\": 0,\n \"SEVERITY.HIGH\": 0,\n \"SEVERITY.LOW\": 0,\n \"SEVERITY.MEDIUM\": 0,\n \"SEVERITY.UNDEFINED\": 0,\n \"loc\": 346,\n \"nosec\": 0,\n \"skipped_tests\": 0\n },\n \"sanic/mixins/middleware.py\": {\n \"CONFIDENCE.HIGH\": 0,\n \"CONFIDENCE.LOW\": 0,\n \"CONFIDENCE.MEDIUM\": 0,\n \"CONFIDENCE.UNDEFINED\": 0,\n \"SEVERITY.HIGH\": 0,\n \"SEVERITY.LOW\": 0,\n \"SEVERITY.MEDIUM\": 0,\n \"SEVERITY.UNDEFINED\": 0,\n \"loc\": 198,\n \"nosec\": 0,\n \"skipped_tests\": 0\n },\n \"sanic/mixins/routes.py\": {\n \"CONFIDENCE.HIGH\": 0,\n \"CONFIDENCE.LOW\": 0,\n \"CONFIDENCE.MEDIUM\": 0,\n \"CONFIDENCE.UNDEFINED\": 0,\n \"SEVERITY.HIGH\": 0,\n \"SEVERITY.LOW\": 0,\n \"SEVERITY.MEDIUM\": 0,\n \"SEVERITY.UNDEFINED\": 0,\n \"loc\": 725,\n \"nosec\": 0,\n \"skipped_tests\": 0\n },\n \"sanic/mixins/signals.py\": {\n \"CONFIDENCE.HIGH\": 0,\n \"CONFIDENCE.LOW\": 0,\n \"CONFIDENCE.MEDIUM\": 0,\n \"CONFIDENCE.UNDEFINED\": 0,\n \"SEVERITY.HIGH\": 0,\n \"SEVERITY.LOW\": 0,\n \"SEVERITY.MEDIUM\": 0,\n \"SEVERITY.UNDEFINED\": 0,\n \"loc\": 113,\n \"nosec\": 0,\n \"skipped_tests\": 0\n },\n \"sanic/mixins/startup.py\": {\n \"CONFIDENCE.HIGH\": 0,\n \"CONFIDENCE.LOW\": 0,\n \"CONFIDENCE.MEDIUM\": 0,\n \"CONFIDENCE.UNDEFINED\": 0,\n \"SEVERITY.HIGH\": 0,\n \"SEVERITY.LOW\": 0,\n \"SEVERITY.MEDIUM\": 0,\n \"SEVERITY.UNDEFINED\": 0,\n \"loc\": 1236,\n \"nosec\": 0,\n \"skipped_tests\": 0\n },\n \"sanic/mixins/static.py\": {\n \"CONFIDENCE.HIGH\": 0,\n \"CONFIDENCE.LOW\": 0,\n \"CONFIDENCE.MEDIUM\": 0,\n \"CONFIDENCE.UNDEFINED\": 0,\n \"SEVERITY.HIGH\": 0,\n \"SEVERITY.LOW\": 0,\n \"SEVERITY.MEDIUM\": 0,\n \"SEVERITY.UNDEFINED\": 0,\n \"loc\": 322,\n \"nosec\": 0,\n \"skipped_tests\": 0\n },\n \"sanic/models/__init__.py\": {\n \"CONFIDENCE.HIGH\": 0,\n \"CONFIDENCE.LOW\": 0,\n \"CONFIDENCE.MEDIUM\": 0,\n \"CONFIDENCE.UNDEFINED\": 0,\n \"SEVERITY.HIGH\": 0,\n \"SEVERITY.LOW\": 0,\n \"SEVERITY.MEDIUM\": 0,\n \"SEVERITY.UNDEFINED\": 0,\n \"loc\": 0,\n \"nosec\": 0,\n \"skipped_tests\": 0\n },\n \"sanic/models/asgi.py\": {\n \"CONFIDENCE.HIGH\": 0,\n \"CONFIDENCE.LOW\": 0,\n \"CONFIDENCE.MEDIUM\": 0,\n \"CONFIDENCE.UNDEFINED\": 0,\n \"SEVERITY.HIGH\": 0,\n \"SEVERITY.LOW\": 0,\n \"SEVERITY.MEDIUM\": 0,\n \"SEVERITY.UNDEFINED\": 0,\n \"loc\": 75,\n \"nosec\": 0,\n \"skipped_tests\": 0\n },\n \"sanic/models/ctx_types.py\": {\n \"CONFIDENCE.HIGH\": 1,\n \"CONFIDENCE.LOW\": 0,\n \"CONFIDENCE.MEDIUM\": 0,\n \"CONFIDENCE.UNDEFINED\": 0,\n \"SEVERITY.HIGH\": 0,\n \"SEVERITY.LOW\": 1,\n \"SEVERITY.MEDIUM\": 0,\n \"SEVERITY.UNDEFINED\": 0,\n \"loc\": 54,\n \"nosec\": 0,\n \"skipped_tests\": 0\n },\n \"sanic/models/futures.py\": {\n \"CONFIDENCE.HIGH\": 0,\n \"CONFIDENCE.LOW\": 0,\n \"CONFIDENCE.MEDIUM\": 0,\n \"CONFIDENCE.UNDEFINED\": 0,\n \"SEVERITY.HIGH\": 0,\n \"SEVERITY.LOW\": 0,\n \"SEVERITY.MEDIUM\": 0,\n \"SEVERITY.UNDEFINED\": 0,\n \"loc\": 61,\n \"nosec\": 0,\n \"skipped_tests\": 0\n },\n \"sanic/models/handler_types.py\": {\n \"CONFIDENCE.HIGH\": 0,\n \"CONFIDENCE.LOW\": 0,\n \"CONFIDENCE.MEDIUM\": 0,\n \"CONFIDENCE.UNDEFINED\": 0,\n \"SEVERITY.HIGH\": 0,\n \"SEVERITY.LOW\": 0,\n \"SEVERITY.MEDIUM\": 0,\n \"SEVERITY.UNDEFINED\": 0,\n \"loc\": 25,\n \"nosec\": 0,\n \"skipped_tests\": 0\n },\n \"sanic/models/http_types.py\": {\n \"CONFIDENCE.HIGH\": 0,\n \"CONFIDENCE.LOW\": 0,\n \"CONFIDENCE.MEDIUM\": 0,\n \"CONFIDENCE.UNDEFINED\": 0,\n \"SEVERITY.HIGH\": 0,\n \"SEVERITY.LOW\": 0,\n \"SEVERITY.MEDIUM\": 0,\n \"SEVERITY.UNDEFINED\": 0,\n \"loc\": 28,\n \"nosec\": 0,\n \"skipped_tests\": 0\n },\n \"sanic/models/protocol_types.py\": {\n \"CONFIDENCE.HIGH\": 0,\n \"CONFIDENCE.LOW\": 0,\n \"CONFIDENCE.MEDIUM\": 0,\n \"CONFIDENCE.UNDEFINED\": 0,\n \"SEVERITY.HIGH\": 0,\n \"SEVERITY.LOW\": 0,\n \"SEVERITY.MEDIUM\": 0,\n \"SEVERITY.UNDEFINED\": 0,\n \"loc\": 20,\n \"nosec\": 0,\n \"skipped_tests\": 0\n },\n \"sanic/models/server_types.py\": {\n \"CONFIDENCE.HIGH\": 0,\n \"CONFIDENCE.LOW\": 0,\n \"CONFIDENCE.MEDIUM\": 0,\n \"CONFIDENCE.UNDEFINED\": 0,\n \"SEVERITY.HIGH\": 0,\n \"SEVERITY.LOW\": 0,\n \"SEVERITY.MEDIUM\": 0,\n \"SEVERITY.UNDEFINED\": 0,\n \"loc\": 60,\n \"nosec\": 0,\n \"skipped_tests\": 0\n },\n \"sanic/pages/__init__.py\": {\n \"CONFIDENCE.HIGH\": 0,\n \"CONFIDENCE.LOW\": 0,\n \"CONFIDENCE.MEDIUM\": 0,\n \"CONFIDENCE.UNDEFINED\": 0,\n \"SEVERITY.HIGH\": 0,\n \"SEVERITY.LOW\": 0,\n \"SEVERITY.MEDIUM\": 0,\n \"SEVERITY.UNDEFINED\": 0,\n \"loc\": 0,\n \"nosec\": 0,\n \"skipped_tests\": 0\n },\n \"sanic/pages/base.py\": {\n \"CONFIDENCE.HIGH\": 0,\n \"CONFIDENCE.LOW\": 0,\n \"CONFIDENCE.MEDIUM\": 0,\n \"CONFIDENCE.UNDEFINED\": 0,\n \"SEVERITY.HIGH\": 0,\n \"SEVERITY.LOW\": 0,\n \"SEVERITY.MEDIUM\": 0,\n \"SEVERITY.UNDEFINED\": 0,\n \"loc\": 67,\n \"nosec\": 0,\n \"skipped_tests\": 0\n },\n \"sanic/pages/css.py\": {\n \"CONFIDENCE.HIGH\": 0,\n \"CONFIDENCE.LOW\": 0,\n \"CONFIDENCE.MEDIUM\": 0,\n \"CONFIDENCE.UNDEFINED\": 0,\n \"SEVERITY.HIGH\": 0,\n \"SEVERITY.LOW\": 0,\n \"SEVERITY.MEDIUM\": 0,\n \"SEVERITY.UNDEFINED\": 0,\n \"loc\": 26,\n \"nosec\": 0,\n \"skipped_tests\": 0\n },\n \"sanic/pages/directory_page.py\": {\n \"CONFIDENCE.HIGH\": 0,\n \"CONFIDENCE.LOW\": 0,\n \"CONFIDENCE.MEDIUM\": 0,\n \"CONFIDENCE.UNDEFINED\": 0,\n \"SEVERITY.HIGH\": 0,\n \"SEVERITY.LOW\": 0,\n \"SEVERITY.MEDIUM\": 0,\n \"SEVERITY.UNDEFINED\": 0,\n \"loc\": 49,\n \"nosec\": 0,\n \"skipped_tests\": 0\n },\n \"sanic/pages/error.py\": {\n \"CONFIDENCE.HIGH\": 0,\n \"CONFIDENCE.LOW\": 0,\n \"CONFIDENCE.MEDIUM\": 0,\n \"CONFIDENCE.UNDEFINED\": 0,\n \"SEVERITY.HIGH\": 0,\n \"SEVERITY.LOW\": 0,\n \"SEVERITY.MEDIUM\": 0,\n \"SEVERITY.UNDEFINED\": 0,\n \"loc\": 89,\n \"nosec\": 0,\n \"skipped_tests\": 0\n },\n \"sanic/request/__init__.py\": {\n \"CONFIDENCE.HIGH\": 0,\n \"CONFIDENCE.LOW\": 0,\n \"CONFIDENCE.MEDIUM\": 0,\n \"CONFIDENCE.UNDEFINED\": 0,\n \"SEVERITY.HIGH\": 0,\n \"SEVERITY.LOW\": 0,\n \"SEVERITY.MEDIUM\": 0,\n \"SEVERITY.UNDEFINED\": 0,\n \"loc\": 9,\n \"nosec\": 0,\n \"skipped_tests\": 0\n },\n \"sanic/request/form.py\": {\n \"CONFIDENCE.HIGH\": 0,\n \"CONFIDENCE.LOW\": 0,\n \"CONFIDENCE.MEDIUM\": 0,\n \"CONFIDENCE.UNDEFINED\": 0,\n \"SEVERITY.HIGH\": 0,\n \"SEVERITY.LOW\": 0,\n \"SEVERITY.MEDIUM\": 0,\n \"SEVERITY.UNDEFINED\": 0,\n \"loc\": 85,\n \"nosec\": 0,\n \"skipped_tests\": 0\n },\n \"sanic/request/parameters.py\": {\n \"CONFIDENCE.HIGH\": 0,\n \"CONFIDENCE.LOW\": 0,\n \"CONFIDENCE.MEDIUM\": 0,\n \"CONFIDENCE.UNDEFINED\": 0,\n \"SEVERITY.HIGH\": 0,\n \"SEVERITY.LOW\": 0,\n \"SEVERITY.MEDIUM\": 0,\n \"SEVERITY.UNDEFINED\": 0,\n \"loc\": 24,\n \"nosec\": 0,\n \"skipped_tests\": 0\n },\n \"sanic/request/types.py\": {\n \"CONFIDENCE.HIGH\": 0,\n \"CONFIDENCE.LOW\": 0,\n \"CONFIDENCE.MEDIUM\": 0,\n \"CONFIDENCE.UNDEFINED\": 0,\n \"SEVERITY.HIGH\": 0,\n \"SEVERITY.LOW\": 0,\n \"SEVERITY.MEDIUM\": 0,\n \"SEVERITY.UNDEFINED\": 0,\n \"loc\": 941,\n \"nosec\": 0,\n \"skipped_tests\": 0\n },\n \"sanic/response/__init__.py\": {\n \"CONFIDENCE.HIGH\": 0,\n \"CONFIDENCE.LOW\": 0,\n \"CONFIDENCE.MEDIUM\": 0,\n \"CONFIDENCE.UNDEFINED\": 0,\n \"SEVERITY.HIGH\": 0,\n \"SEVERITY.LOW\": 0,\n \"SEVERITY.MEDIUM\": 0,\n \"SEVERITY.UNDEFINED\": 0,\n \"loc\": 34,\n \"nosec\": 0,\n \"skipped_tests\": 0\n },\n \"sanic/response/convenience.py\": {\n \"CONFIDENCE.HIGH\": 0,\n \"CONFIDENCE.LOW\": 0,\n \"CONFIDENCE.MEDIUM\": 0,\n \"CONFIDENCE.UNDEFINED\": 0,\n \"SEVERITY.HIGH\": 0,\n \"SEVERITY.LOW\": 0,\n \"SEVERITY.MEDIUM\": 0,\n \"SEVERITY.UNDEFINED\": 0,\n \"loc\": 335,\n \"nosec\": 0,\n \"skipped_tests\": 0\n },\n \"sanic/response/types.py\": {\n \"CONFIDENCE.HIGH\": 0,\n \"CONFIDENCE.LOW\": 0,\n \"CONFIDENCE.MEDIUM\": 0,\n \"CONFIDENCE.UNDEFINED\": 0,\n \"SEVERITY.HIGH\": 0,\n \"SEVERITY.LOW\": 0,\n \"SEVERITY.MEDIUM\": 0,\n \"SEVERITY.UNDEFINED\": 0,\n \"loc\": 449,\n \"nosec\": 0,\n \"skipped_tests\": 0\n },\n \"sanic/router.py\": {\n \"CONFIDENCE.HIGH\": 0,\n \"CONFIDENCE.LOW\": 0,\n \"CONFIDENCE.MEDIUM\": 0,\n \"CONFIDENCE.UNDEFINED\": 0,\n \"SEVERITY.HIGH\": 0,\n \"SEVERITY.LOW\": 0,\n \"SEVERITY.MEDIUM\": 0,\n \"SEVERITY.UNDEFINED\": 0,\n \"loc\": 222,\n \"nosec\": 0,\n \"skipped_tests\": 0\n },\n \"sanic/server/__init__.py\": {\n \"CONFIDENCE.HIGH\": 0,\n \"CONFIDENCE.LOW\": 0,\n \"CONFIDENCE.MEDIUM\": 0,\n \"CONFIDENCE.UNDEFINED\": 0,\n \"SEVERITY.HIGH\": 0,\n \"SEVERITY.LOW\": 0,\n \"SEVERITY.MEDIUM\": 0,\n \"SEVERITY.UNDEFINED\": 0,\n \"loc\": 13,\n \"nosec\": 0,\n \"skipped_tests\": 0\n },\n \"sanic/server/async_server.py\": {\n \"CONFIDENCE.HIGH\": 0,\n \"CONFIDENCE.LOW\": 0,\n \"CONFIDENCE.MEDIUM\": 0,\n \"CONFIDENCE.UNDEFINED\": 0,\n \"SEVERITY.HIGH\": 0,\n \"SEVERITY.LOW\": 0,\n \"SEVERITY.MEDIUM\": 0,\n \"SEVERITY.UNDEFINED\": 0,\n \"loc\": 89,\n \"nosec\": 0,\n \"skipped_tests\": 0\n },\n \"sanic/server/events.py\": {\n \"CONFIDENCE.HIGH\": 0,\n \"CONFIDENCE.LOW\": 0,\n \"CONFIDENCE.MEDIUM\": 0,\n \"CONFIDENCE.UNDEFINED\": 0,\n \"SEVERITY.HIGH\": 0,\n \"SEVERITY.LOW\": 0,\n \"SEVERITY.MEDIUM\": 0,\n \"SEVERITY.UNDEFINED\": 0,\n \"loc\": 30,\n \"nosec\": 0,\n \"skipped_tests\": 0\n },\n \"sanic/server/goodbye.py\": {\n \"CONFIDENCE.HIGH\": 0,\n \"CONFIDENCE.LOW\": 0,\n \"CONFIDENCE.MEDIUM\": 0,\n \"CONFIDENCE.UNDEFINED\": 0,\n \"SEVERITY.HIGH\": 0,\n \"SEVERITY.LOW\": 0,\n \"SEVERITY.MEDIUM\": 0,\n \"SEVERITY.UNDEFINED\": 0,\n \"loc\": 21,\n \"nosec\": 0,\n \"skipped_tests\": 1\n },\n \"sanic/server/loop.py\": {\n \"CONFIDENCE.HIGH\": 0,\n \"CONFIDENCE.LOW\": 0,\n \"CONFIDENCE.MEDIUM\": 0,\n \"CONFIDENCE.UNDEFINED\": 0,\n \"SEVERITY.HIGH\": 0,\n \"SEVERITY.LOW\": 0,\n \"SEVERITY.MEDIUM\": 0,\n \"SEVERITY.UNDEFINED\": 0,\n \"loc\": 54,\n \"nosec\": 0,\n \"skipped_tests\": 0\n },\n \"sanic/server/protocols/__init__.py\": {\n \"CONFIDENCE.HIGH\": 0,\n \"CONFIDENCE.LOW\": 0,\n \"CONFIDENCE.MEDIUM\": 0,\n \"CONFIDENCE.UNDEFINED\": 0,\n \"SEVERITY.HIGH\": 0,\n \"SEVERITY.LOW\": 0,\n \"SEVERITY.MEDIUM\": 0,\n \"SEVERITY.UNDEFINED\": 0,\n \"loc\": 0,\n \"nosec\": 0,\n \"skipped_tests\": 0\n },\n \"sanic/server/protocols/base_protocol.py\": {\n \"CONFIDENCE.HIGH\": 0,\n \"CONFIDENCE.LOW\": 0,\n \"CONFIDENCE.MEDIUM\": 0,\n \"CONFIDENCE.UNDEFINED\": 0,\n \"SEVERITY.HIGH\": 0,\n \"SEVERITY.LOW\": 0,\n \"SEVERITY.MEDIUM\": 0,\n \"SEVERITY.UNDEFINED\": 0,\n \"loc\": 186,\n \"nosec\": 0,\n \"skipped_tests\": 0\n },\n \"sanic/server/protocols/http_protocol.py\": {\n \"CONFIDENCE.HIGH\": 0,\n \"CONFIDENCE.LOW\": 0,\n \"CONFIDENCE.MEDIUM\": 0,\n \"CONFIDENCE.UNDEFINED\": 0,\n \"SEVERITY.HIGH\": 0,\n \"SEVERITY.LOW\": 0,\n \"SEVERITY.MEDIUM\": 0,\n \"SEVERITY.UNDEFINED\": 0,\n \"loc\": 305,\n \"nosec\": 0,\n \"skipped_tests\": 0\n },\n \"sanic/server/protocols/websocket_protocol.py\": {\n \"CONFIDENCE.HIGH\": 0,\n \"CONFIDENCE.LOW\": 0,\n \"CONFIDENCE.MEDIUM\": 0,\n \"CONFIDENCE.UNDEFINED\": 0,\n \"SEVERITY.HIGH\": 0,\n \"SEVERITY.LOW\": 0,\n \"SEVERITY.MEDIUM\": 0,\n \"SEVERITY.UNDEFINED\": 0,\n \"loc\": 197,\n \"nosec\": 0,\n \"skipped_tests\": 0\n },\n \"sanic/server/runners.py\": {\n \"CONFIDENCE.HIGH\": 0,\n \"CONFIDENCE.LOW\": 0,\n \"CONFIDENCE.MEDIUM\": 0,\n \"CONFIDENCE.UNDEFINED\": 0,\n \"SEVERITY.HIGH\": 0,\n \"SEVERITY.LOW\": 0,\n \"SEVERITY.MEDIUM\": 0,\n \"SEVERITY.UNDEFINED\": 0,\n \"loc\": 306,\n \"nosec\": 0,\n \"skipped_tests\": 0\n },\n \"sanic/server/socket.py\": {\n \"CONFIDENCE.HIGH\": 0,\n \"CONFIDENCE.LOW\": 0,\n \"CONFIDENCE.MEDIUM\": 0,\n \"CONFIDENCE.UNDEFINED\": 0,\n \"SEVERITY.HIGH\": 0,\n \"SEVERITY.LOW\": 0,\n \"SEVERITY.MEDIUM\": 0,\n \"SEVERITY.UNDEFINED\": 0,\n \"loc\": 115,\n \"nosec\": 0,\n \"skipped_tests\": 0\n },\n \"sanic/server/websockets/__init__.py\": {\n \"CONFIDENCE.HIGH\": 0,\n \"CONFIDENCE.LOW\": 0,\n \"CONFIDENCE.MEDIUM\": 0,\n \"CONFIDENCE.UNDEFINED\": 0,\n \"SEVERITY.HIGH\": 0,\n \"SEVERITY.LOW\": 0,\n \"SEVERITY.MEDIUM\": 0,\n \"SEVERITY.UNDEFINED\": 0,\n \"loc\": 0,\n \"nosec\": 0,\n \"skipped_tests\": 0\n },\n \"sanic/server/websockets/connection.py\": {\n \"CONFIDENCE.HIGH\": 0,\n \"CONFIDENCE.LOW\": 0,\n \"CONFIDENCE.MEDIUM\": 0,\n \"CONFIDENCE.UNDEFINED\": 0,\n \"SEVERITY.HIGH\": 0,\n \"SEVERITY.LOW\": 0,\n \"SEVERITY.MEDIUM\": 0,\n \"SEVERITY.UNDEFINED\": 0,\n \"loc\": 66,\n \"nosec\": 0,\n \"skipped_tests\": 0\n },\n \"sanic/server/websockets/frame.py\": {\n \"CONFIDENCE.HIGH\": 0,\n \"CONFIDENCE.LOW\": 0,\n \"CONFIDENCE.MEDIUM\": 0,\n \"CONFIDENCE.UNDEFINED\": 0,\n \"SEVERITY.HIGH\": 0,\n \"SEVERITY.LOW\": 0,\n \"SEVERITY.MEDIUM\": 0,\n \"SEVERITY.UNDEFINED\": 0,\n \"loc\": 208,\n \"nosec\": 0,\n \"skipped_tests\": 0\n },\n \"sanic/server/websockets/impl.py\": {\n \"CONFIDENCE.HIGH\": 1,\n \"CONFIDENCE.LOW\": 0,\n \"CONFIDENCE.MEDIUM\": 0,\n \"CONFIDENCE.UNDEFINED\": 0,\n \"SEVERITY.HIGH\": 0,\n \"SEVERITY.LOW\": 1,\n \"SEVERITY.MEDIUM\": 0,\n \"SEVERITY.UNDEFINED\": 0,\n \"loc\": 720,\n \"nosec\": 0,\n \"skipped_tests\": 0\n },\n \"sanic/signals.py\": {\n \"CONFIDENCE.HIGH\": 0,\n \"CONFIDENCE.LOW\": 0,\n \"CONFIDENCE.MEDIUM\": 0,\n \"CONFIDENCE.UNDEFINED\": 0,\n \"SEVERITY.HIGH\": 0,\n \"SEVERITY.LOW\": 0,\n \"SEVERITY.MEDIUM\": 0,\n \"SEVERITY.UNDEFINED\": 0,\n \"loc\": 349,\n \"nosec\": 0,\n \"skipped_tests\": 0\n },\n \"sanic/simple.py\": {\n \"CONFIDENCE.HIGH\": 0,\n \"CONFIDENCE.LOW\": 0,\n \"CONFIDENCE.MEDIUM\": 0,\n \"CONFIDENCE.UNDEFINED\": 0,\n \"SEVERITY.HIGH\": 0,\n \"SEVERITY.LOW\": 0,\n \"SEVERITY.MEDIUM\": 0,\n \"SEVERITY.UNDEFINED\": 0,\n \"loc\": 13,\n \"nosec\": 0,\n \"skipped_tests\": 0\n },\n \"sanic/touchup/__init__.py\": {\n \"CONFIDENCE.HIGH\": 0,\n \"CONFIDENCE.LOW\": 0,\n \"CONFIDENCE.MEDIUM\": 0,\n \"CONFIDENCE.UNDEFINED\": 0,\n \"SEVERITY.HIGH\": 0,\n \"SEVERITY.LOW\": 0,\n \"SEVERITY.MEDIUM\": 0,\n \"SEVERITY.UNDEFINED\": 0,\n \"loc\": 6,\n \"nosec\": 0,\n \"skipped_tests\": 0\n },\n \"sanic/touchup/meta.py\": {\n \"CONFIDENCE.HIGH\": 0,\n \"CONFIDENCE.LOW\": 0,\n \"CONFIDENCE.MEDIUM\": 0,\n \"CONFIDENCE.UNDEFINED\": 0,\n \"SEVERITY.HIGH\": 0,\n \"SEVERITY.LOW\": 0,\n \"SEVERITY.MEDIUM\": 0,\n \"SEVERITY.UNDEFINED\": 0,\n \"loc\": 17,\n \"nosec\": 0,\n \"skipped_tests\": 0\n },\n \"sanic/touchup/schemes/__init__.py\": {\n \"CONFIDENCE.HIGH\": 0,\n \"CONFIDENCE.LOW\": 0,\n \"CONFIDENCE.MEDIUM\": 0,\n \"CONFIDENCE.UNDEFINED\": 0,\n \"SEVERITY.HIGH\": 0,\n \"SEVERITY.LOW\": 0,\n \"SEVERITY.MEDIUM\": 0,\n \"SEVERITY.UNDEFINED\": 0,\n \"loc\": 4,\n \"nosec\": 0,\n \"skipped_tests\": 0\n },\n \"sanic/touchup/schemes/altsvc.py\": {\n \"CONFIDENCE.HIGH\": 1,\n \"CONFIDENCE.LOW\": 0,\n \"CONFIDENCE.MEDIUM\": 0,\n \"CONFIDENCE.UNDEFINED\": 0,\n \"SEVERITY.HIGH\": 0,\n \"SEVERITY.LOW\": 1,\n \"SEVERITY.MEDIUM\": 0,\n \"SEVERITY.UNDEFINED\": 0,\n \"loc\": 42,\n \"nosec\": 0,\n \"skipped_tests\": 0\n },\n \"sanic/touchup/schemes/base.py\": {\n \"CONFIDENCE.HIGH\": 0,\n \"CONFIDENCE.LOW\": 0,\n \"CONFIDENCE.MEDIUM\": 0,\n \"CONFIDENCE.UNDEFINED\": 0,\n \"SEVERITY.HIGH\": 0,\n \"SEVERITY.LOW\": 0,\n \"SEVERITY.MEDIUM\": 0,\n \"SEVERITY.UNDEFINED\": 0,\n \"loc\": 28,\n \"nosec\": 1,\n \"skipped_tests\": 0\n },\n \"sanic/touchup/schemes/ode.py\": {\n \"CONFIDENCE.HIGH\": 0,\n \"CONFIDENCE.LOW\": 0,\n \"CONFIDENCE.MEDIUM\": 0,\n \"CONFIDENCE.UNDEFINED\": 0,\n \"SEVERITY.HIGH\": 0,\n \"SEVERITY.LOW\": 0,\n \"SEVERITY.MEDIUM\": 0,\n \"SEVERITY.UNDEFINED\": 0,\n \"loc\": 73,\n \"nosec\": 0,\n \"skipped_tests\": 0\n },\n \"sanic/touchup/service.py\": {\n \"CONFIDENCE.HIGH\": 0,\n \"CONFIDENCE.LOW\": 0,\n \"CONFIDENCE.MEDIUM\": 0,\n \"CONFIDENCE.UNDEFINED\": 0,\n \"SEVERITY.HIGH\": 0,\n \"SEVERITY.LOW\": 0,\n \"SEVERITY.MEDIUM\": 0,\n \"SEVERITY.UNDEFINED\": 0,\n \"loc\": 22,\n \"nosec\": 0,\n \"skipped_tests\": 0\n },\n \"sanic/types/__init__.py\": {\n \"CONFIDENCE.HIGH\": 0,\n \"CONFIDENCE.LOW\": 0,\n \"CONFIDENCE.MEDIUM\": 0,\n \"CONFIDENCE.UNDEFINED\": 0,\n \"SEVERITY.HIGH\": 0,\n \"SEVERITY.LOW\": 0,\n \"SEVERITY.MEDIUM\": 0,\n \"SEVERITY.UNDEFINED\": 0,\n \"loc\": 2,\n \"nosec\": 0,\n \"skipped_tests\": 0\n },\n \"sanic/types/hashable_dict.py\": {\n \"CONFIDENCE.HIGH\": 0,\n \"CONFIDENCE.LOW\": 0,\n \"CONFIDENCE.MEDIUM\": 0,\n \"CONFIDENCE.UNDEFINED\": 0,\n \"SEVERITY.HIGH\": 0,\n \"SEVERITY.LOW\": 0,\n \"SEVERITY.MEDIUM\": 0,\n \"SEVERITY.UNDEFINED\": 0,\n \"loc\": 3,\n \"nosec\": 0,\n \"skipped_tests\": 0\n },\n \"sanic/types/shared_ctx.py\": {\n \"CONFIDENCE.HIGH\": 0,\n \"CONFIDENCE.LOW\": 0,\n \"CONFIDENCE.MEDIUM\": 0,\n \"CONFIDENCE.UNDEFINED\": 0,\n \"SEVERITY.HIGH\": 0,\n \"SEVERITY.LOW\": 0,\n \"SEVERITY.MEDIUM\": 0,\n \"SEVERITY.UNDEFINED\": 0,\n \"loc\": 49,\n \"nosec\": 0,\n \"skipped_tests\": 0\n },\n \"sanic/utils.py\": {\n \"CONFIDENCE.HIGH\": 1,\n \"CONFIDENCE.LOW\": 0,\n \"CONFIDENCE.MEDIUM\": 0,\n \"CONFIDENCE.UNDEFINED\": 0,\n \"SEVERITY.HIGH\": 0,\n \"SEVERITY.LOW\": 1,\n \"SEVERITY.MEDIUM\": 0,\n \"SEVERITY.UNDEFINED\": 0,\n \"loc\": 110,\n \"nosec\": 1,\n \"skipped_tests\": 0\n },\n \"sanic/views.py\": {\n \"CONFIDENCE.HIGH\": 0,\n \"CONFIDENCE.LOW\": 0,\n \"CONFIDENCE.MEDIUM\": 0,\n \"CONFIDENCE.UNDEFINED\": 0,\n \"SEVERITY.HIGH\": 0,\n \"SEVERITY.LOW\": 0,\n \"SEVERITY.MEDIUM\": 0,\n \"SEVERITY.UNDEFINED\": 0,\n \"loc\": 198,\n \"nosec\": 0,\n \"skipped_tests\": 0\n },\n \"sanic/worker/__init__.py\": {\n \"CONFIDENCE.HIGH\": 0,\n \"CONFIDENCE.LOW\": 0,\n \"CONFIDENCE.MEDIUM\": 0,\n \"CONFIDENCE.UNDEFINED\": 0,\n \"SEVERITY.HIGH\": 0,\n \"SEVERITY.LOW\": 0,\n \"SEVERITY.MEDIUM\": 0,\n \"SEVERITY.UNDEFINED\": 0,\n \"loc\": 0,\n \"nosec\": 0,\n \"skipped_tests\": 0\n },\n \"sanic/worker/constants.py\": {\n \"CONFIDENCE.HIGH\": 0,\n \"CONFIDENCE.LOW\": 0,\n \"CONFIDENCE.MEDIUM\": 0,\n \"CONFIDENCE.UNDEFINED\": 0,\n \"SEVERITY.HIGH\": 0,\n \"SEVERITY.LOW\": 0,\n \"SEVERITY.MEDIUM\": 0,\n \"SEVERITY.UNDEFINED\": 0,\n \"loc\": 18,\n \"nosec\": 0,\n \"skipped_tests\": 0\n },\n \"sanic/worker/inspector.py\": {\n \"CONFIDENCE.HIGH\": 0,\n \"CONFIDENCE.LOW\": 0,\n \"CONFIDENCE.MEDIUM\": 0,\n \"CONFIDENCE.UNDEFINED\": 0,\n \"SEVERITY.HIGH\": 0,\n \"SEVERITY.LOW\": 0,\n \"SEVERITY.MEDIUM\": 0,\n \"SEVERITY.UNDEFINED\": 0,\n \"loc\": 132,\n \"nosec\": 0,\n \"skipped_tests\": 0\n },\n \"sanic/worker/loader.py\": {\n \"CONFIDENCE.HIGH\": 0,\n \"CONFIDENCE.LOW\": 0,\n \"CONFIDENCE.MEDIUM\": 0,\n \"CONFIDENCE.UNDEFINED\": 0,\n \"SEVERITY.HIGH\": 0,\n \"SEVERITY.LOW\": 0,\n \"SEVERITY.MEDIUM\": 0,\n \"SEVERITY.UNDEFINED\": 0,\n \"loc\": 137,\n \"nosec\": 0,\n \"skipped_tests\": 0\n },\n \"sanic/worker/manager.py\": {\n \"CONFIDENCE.HIGH\": 0,\n \"CONFIDENCE.LOW\": 0,\n \"CONFIDENCE.MEDIUM\": 0,\n \"CONFIDENCE.UNDEFINED\": 0,\n \"SEVERITY.HIGH\": 0,\n \"SEVERITY.LOW\": 0,\n \"SEVERITY.MEDIUM\": 0,\n \"SEVERITY.UNDEFINED\": 0,\n \"loc\": 473,\n \"nosec\": 0,\n \"skipped_tests\": 1\n },\n \"sanic/worker/multiplexer.py\": {\n \"CONFIDENCE.HIGH\": 0,\n \"CONFIDENCE.LOW\": 0,\n \"CONFIDENCE.MEDIUM\": 0,\n \"CONFIDENCE.UNDEFINED\": 0,\n \"SEVERITY.HIGH\": 0,\n \"SEVERITY.LOW\": 0,\n \"SEVERITY.MEDIUM\": 0,\n \"SEVERITY.UNDEFINED\": 0,\n \"loc\": 143,\n \"nosec\": 0,\n \"skipped_tests\": 0\n },\n \"sanic/worker/process.py\": {\n \"CONFIDENCE.HIGH\": 0,\n \"CONFIDENCE.LOW\": 0,\n \"CONFIDENCE.MEDIUM\": 0,\n \"CONFIDENCE.UNDEFINED\": 0,\n \"SEVERITY.HIGH\": 0,\n \"SEVERITY.LOW\": 0,\n \"SEVERITY.MEDIUM\": 0,\n \"SEVERITY.UNDEFINED\": 0,\n \"loc\": 247,\n \"nosec\": 0,\n \"skipped_tests\": 0\n },\n \"sanic/worker/reloader.py\": {\n \"CONFIDENCE.HIGH\": 0,\n \"CONFIDENCE.LOW\": 0,\n \"CONFIDENCE.MEDIUM\": 0,\n \"CONFIDENCE.UNDEFINED\": 0,\n \"SEVERITY.HIGH\": 0,\n \"SEVERITY.LOW\": 0,\n \"SEVERITY.MEDIUM\": 0,\n \"SEVERITY.UNDEFINED\": 0,\n \"loc\": 103,\n \"nosec\": 0,\n \"skipped_tests\": 0\n },\n \"sanic/worker/restarter.py\": {\n \"CONFIDENCE.HIGH\": 0,\n \"CONFIDENCE.LOW\": 0,\n \"CONFIDENCE.MEDIUM\": 0,\n \"CONFIDENCE.UNDEFINED\": 0,\n \"SEVERITY.HIGH\": 0,\n \"SEVERITY.LOW\": 0,\n \"SEVERITY.MEDIUM\": 0,\n \"SEVERITY.UNDEFINED\": 0,\n \"loc\": 81,\n \"nosec\": 0,\n \"skipped_tests\": 0\n },\n \"sanic/worker/serve.py\": {\n \"CONFIDENCE.HIGH\": 0,\n \"CONFIDENCE.LOW\": 0,\n \"CONFIDENCE.MEDIUM\": 0,\n \"CONFIDENCE.UNDEFINED\": 0,\n \"SEVERITY.HIGH\": 0,\n \"SEVERITY.LOW\": 0,\n \"SEVERITY.MEDIUM\": 0,\n \"SEVERITY.UNDEFINED\": 0,\n \"loc\": 127,\n \"nosec\": 0,\n \"skipped_tests\": 0\n },\n \"sanic/worker/state.py\": {\n \"CONFIDENCE.HIGH\": 0,\n \"CONFIDENCE.LOW\": 0,\n \"CONFIDENCE.MEDIUM\": 0,\n \"CONFIDENCE.UNDEFINED\": 0,\n \"SEVERITY.HIGH\": 0,\n \"SEVERITY.LOW\": 0,\n \"SEVERITY.MEDIUM\": 0,\n \"SEVERITY.UNDEFINED\": 0,\n \"loc\": 65,\n \"nosec\": 0,\n \"skipped_tests\": 0\n }\n },\n \"results\": [\n {\n \"code\": \"931 if blueprint.name in self.blueprints:\\n932 assert self.blueprints[blueprint.name] is blueprint, (\\n933 'A blueprint with the name \\\"%s\\\" is already registered. '\\n934 \\\"Blueprint names must be unique.\\\" % (blueprint.name,)\\n935 )\\n936 else:\\n\",\n \"col_offset\": 12,\n \"end_col_offset\": 13,\n \"filename\": \"sanic/app.py\",\n \"issue_confidence\": \"HIGH\",\n \"issue_cwe\": {\n \"id\": 703,\n \"link\": \"https://cwe.mitre.org/data/definitions/703.html\"\n },\n \"issue_severity\": \"LOW\",\n \"issue_text\": \"Use of assert detected. The enclosed code will be removed when compiling to optimised byte code.\",\n \"line_number\": 932,\n \"line_range\": [\n 932,\n 933,\n 934,\n 935\n ],\n \"more_info\": \"https://bandit.readthedocs.io/en/1.8.6/plugins/b101_assert_used.html\",\n \"test_id\": \"B101\",\n \"test_name\": \"assert_used\"\n },\n {\n \"code\": \"77 ):\\n78 assert repl_app, \\\"No Sanic app has been registered.\\\"\\n79 headers = headers or {}\\n\",\n \"col_offset\": 4,\n \"end_col_offset\": 56,\n \"filename\": \"sanic/cli/console.py\",\n \"issue_confidence\": \"HIGH\",\n \"issue_cwe\": {\n \"id\": 703,\n \"link\": \"https://cwe.mitre.org/data/definitions/703.html\"\n },\n \"issue_severity\": \"LOW\",\n \"issue_text\": \"Use of assert detected. The enclosed code will be removed when compiling to optimised byte code.\",\n \"line_number\": 78,\n \"line_range\": [\n 78\n ],\n \"more_info\": \"https://bandit.readthedocs.io/en/1.8.6/plugins/b101_assert_used.html\",\n \"test_id\": \"B101\",\n \"test_name\": \"assert_used\"\n },\n {\n \"code\": \"96 async def respond(request) -> HTTPResponse:\\n97 assert repl_app, \\\"No Sanic app has been registered.\\\"\\n98 await repl_app.handle_request(request)\\n\",\n \"col_offset\": 4,\n \"end_col_offset\": 56,\n \"filename\": \"sanic/cli/console.py\",\n \"issue_confidence\": \"HIGH\",\n \"issue_cwe\": {\n \"id\": 703,\n \"link\": \"https://cwe.mitre.org/data/definitions/703.html\"\n },\n \"issue_severity\": \"LOW\",\n \"issue_text\": \"Use of assert detected. The enclosed code will be removed when compiling to optimised byte code.\",\n \"line_number\": 97,\n \"line_range\": [\n 97\n ],\n \"more_info\": \"https://bandit.readthedocs.io/en/1.8.6/plugins/b101_assert_used.html\",\n \"test_id\": \"B101\",\n \"test_name\": \"assert_used\"\n },\n {\n \"code\": \"98 await repl_app.handle_request(request)\\n99 assert repl_response\\n100 return repl_response\\n\",\n \"col_offset\": 4,\n \"end_col_offset\": 24,\n \"filename\": \"sanic/cli/console.py\",\n \"issue_confidence\": \"HIGH\",\n \"issue_cwe\": {\n \"id\": 703,\n \"link\": \"https://cwe.mitre.org/data/definitions/703.html\"\n },\n \"issue_severity\": \"LOW\",\n \"issue_text\": \"Use of assert detected. The enclosed code will be removed when compiling to optimised byte code.\",\n \"line_number\": 99,\n \"line_range\": [\n 99\n ],\n \"more_info\": \"https://bandit.readthedocs.io/en/1.8.6/plugins/b101_assert_used.html\",\n \"test_id\": \"B101\",\n \"test_name\": \"assert_used\"\n },\n {\n \"code\": \"411 if not addr and proxies_count:\\n412 assert proxies_count > 0\\n413 try:\\n\",\n \"col_offset\": 8,\n \"end_col_offset\": 32,\n \"filename\": \"sanic/headers.py\",\n \"issue_confidence\": \"HIGH\",\n \"issue_cwe\": {\n \"id\": 703,\n \"link\": \"https://cwe.mitre.org/data/definitions/703.html\"\n },\n \"issue_severity\": \"LOW\",\n \"issue_text\": \"Use of assert detected. The enclosed code will be removed when compiling to optimised byte code.\",\n \"line_number\": 412,\n \"line_range\": [\n 412\n ],\n \"more_info\": \"https://bandit.readthedocs.io/en/1.8.6/plugins/b101_assert_used.html\",\n \"test_id\": \"B101\",\n \"test_name\": \"assert_used\"\n },\n {\n \"code\": \"3 import ssl\\n4 import subprocess\\n5 import sys\\n\",\n \"col_offset\": 0,\n \"end_col_offset\": 17,\n \"filename\": \"sanic/http/tls/creators.py\",\n \"issue_confidence\": \"HIGH\",\n \"issue_cwe\": {\n \"id\": 78,\n \"link\": \"https://cwe.mitre.org/data/definitions/78.html\"\n },\n \"issue_severity\": \"LOW\",\n \"issue_text\": \"Consider possible security implications associated with the subprocess module.\",\n \"line_number\": 4,\n \"line_range\": [\n 4\n ],\n \"more_info\": \"https://bandit.readthedocs.io/en/1.8.6/blacklists/blacklist_imports.html#b404-import-subprocess\",\n \"test_id\": \"B404\",\n \"test_name\": \"blacklist\"\n },\n {\n \"code\": \"45 \\n46 assert isinstance(desc, str) and isinstance(\\n47 name, str\\n48 ) # Just to make mypy happy\\n49 \\n\",\n \"col_offset\": 8,\n \"end_col_offset\": 9,\n \"filename\": \"sanic/models/ctx_types.py\",\n \"issue_confidence\": \"HIGH\",\n \"issue_cwe\": {\n \"id\": 703,\n \"link\": \"https://cwe.mitre.org/data/definitions/703.html\"\n },\n \"issue_severity\": \"LOW\",\n \"issue_text\": \"Use of assert detected. The enclosed code will be removed when compiling to optimised byte code.\",\n \"line_number\": 46,\n \"line_range\": [\n 46,\n 47,\n 48\n ],\n \"more_info\": \"https://bandit.readthedocs.io/en/1.8.6/plugins/b101_assert_used.html\",\n \"test_id\": \"B101\",\n \"test_name\": \"assert_used\"\n },\n {\n \"code\": \"766 while data is None or data in self.pings:\\n767 data = struct.pack(\\\"!I\\\", random.getrandbits(32))\\n768 \\n\",\n \"col_offset\": 41,\n \"end_col_offset\": 63,\n \"filename\": \"sanic/server/websockets/impl.py\",\n \"issue_confidence\": \"HIGH\",\n \"issue_cwe\": {\n \"id\": 330,\n \"link\": \"https://cwe.mitre.org/data/definitions/330.html\"\n },\n \"issue_severity\": \"LOW\",\n \"issue_text\": \"Standard pseudo-random generators are not suitable for security/cryptographic purposes.\",\n \"line_number\": 767,\n \"line_range\": [\n 767\n ],\n \"more_info\": \"https://bandit.readthedocs.io/en/1.8.6/blacklists/blacklist_calls.html#b311-random\",\n \"test_id\": \"B311\",\n \"test_name\": \"blacklist\"\n },\n {\n \"code\": \"33 return None\\n34 assert isinstance(node.value, Constant)\\n35 node.value.value = self.value()\\n\",\n \"col_offset\": 12,\n \"end_col_offset\": 51,\n \"filename\": \"sanic/touchup/schemes/altsvc.py\",\n \"issue_confidence\": \"HIGH\",\n \"issue_cwe\": {\n \"id\": 703,\n \"link\": \"https://cwe.mitre.org/data/definitions/703.html\"\n },\n \"issue_severity\": \"LOW\",\n \"issue_text\": \"Use of assert detected. The enclosed code will be removed when compiling to optimised byte code.\",\n \"line_number\": 34,\n \"line_range\": [\n 34\n ],\n \"more_info\": \"https://bandit.readthedocs.io/en/1.8.6/plugins/b101_assert_used.html\",\n \"test_id\": \"B101\",\n \"test_name\": \"assert_used\"\n },\n {\n \"code\": \"106 )\\n107 assert _mod_spec is not None # type assertion for mypy\\n108 module = module_from_spec(_mod_spec)\\n\",\n \"col_offset\": 12,\n \"end_col_offset\": 40,\n \"filename\": \"sanic/utils.py\",\n \"issue_confidence\": \"HIGH\",\n \"issue_cwe\": {\n \"id\": 703,\n \"link\": \"https://cwe.mitre.org/data/definitions/703.html\"\n },\n \"issue_severity\": \"LOW\",\n \"issue_text\": \"Use of assert detected. The enclosed code will be removed when compiling to optimised byte code.\",\n \"line_number\": 107,\n \"line_range\": [\n 107\n ],\n \"more_info\": \"https://bandit.readthedocs.io/en/1.8.6/plugins/b101_assert_used.html\",\n \"test_id\": \"B101\",\n \"test_name\": \"assert_used\"\n }\n ]\n}" }, { "path": "changelogs/.gitignore", "content": "# Except this file\n!.gitignore" }, { "path": "changelogs/1892.removal.rst", "content": "Remove [version] section.\n" }, { "path": "changelogs/1904.feature.rst", "content": "Adds WEBSOCKET_PING_TIMEOUT and WEBSOCKET_PING_INTERVAL configuration values\n\nAllows setting the ping_interval and ping_timeout arguments when initializing `WebSocketCommonProtocol`." }, { "path": "changelogs/1970.misc.rst", "content": "Adds py.typed file to expose type information to other packages.\n" }, { "path": "codecov.yml", "content": "coverage:\n status:\n patch:\n default:\n target: auto\n threshold: 0.75\n informational: true\n project:\n default:\n target: auto\n threshold: 0.5\n precision: 3\ncodecov:\n require_ci_to_pass: false\nignore:\n - \"sanic/__main__.py\"\n - \"sanic/compat.py\"\n - \"sanic/simple.py\"\n - \"sanic/utils.py\"\n - \"sanic/cli/\"\n - \"sanic/pages/\"\n - \".github/\"\n - \"changelogs/\"\n - \"docker/\"\n - \"docs/\"\n - \"examples/\"\n - \"scripts/\"\n - \"tests/\"\n" }, { "path": "crowdin.yml", "content": "files:\n - source: /guide/content/en/**/*.md\n translation: /guide/content/%two_letters_code%/**/%original_file_name%\n" }, { "path": "docker/Dockerfile", "content": "ARG BASE_IMAGE_ORG\nARG BASE_IMAGE_NAME\nARG BASE_IMAGE_TAG\n\nFROM ${BASE_IMAGE_ORG}/${BASE_IMAGE_NAME}:${BASE_IMAGE_TAG}\n\nRUN apk update\nRUN update-ca-certificates\n\nARG SANIC_PYPI_VERSION\n\nRUN pip install -U pip && pip install sanic==${SANIC_PYPI_VERSION}\nRUN apk del build-base\n" }, { "path": "docker/Dockerfile-base", "content": "ARG PYTHON_VERSION\n\nFROM python:${PYTHON_VERSION}-alpine\nRUN apk update\nRUN apk add --no-cache --update build-base \\\n ca-certificates \\\n openssl\nRUN update-ca-certificates\nRUN rm -rf /var/cache/apk/*\n" }, { "path": "docs/Makefile", "content": "# Makefile for Sphinx documentation\n#\n\n# You can set these variables from the command line.\nSPHINXOPTS =\nSPHINXBUILD = sphinx-build\nPAPER =\nBUILDDIR = _build\n\n# Internal variables.\nPAPEROPT_a4 = -D latex_paper_size=a4\nPAPEROPT_letter = -D latex_paper_size=letter\nALLSPHINXOPTS = -d $(BUILDDIR)/doctrees $(PAPEROPT_$(PAPER)) $(SPHINXOPTS) .\n# the i18n builder cannot share the environment and doctrees with the others\nI18NSPHINXOPTS = $(PAPEROPT_$(PAPER)) $(SPHINXOPTS) .\n\n.PHONY: help\nhelp:\n\t@echo \"Please use \\`make ' where is one of\"\n\t@echo \" html to make standalone HTML files\"\n\t@echo \" dirhtml to make HTML files named index.html in directories\"\n\t@echo \" singlehtml to make a single large HTML file\"\n\t@echo \" pickle to make pickle files\"\n\t@echo \" json to make JSON files\"\n\t@echo \" htmlhelp to make HTML files and a HTML help project\"\n\t@echo \" qthelp to make HTML files and a qthelp project\"\n\t@echo \" applehelp to make an Apple Help Book\"\n\t@echo \" devhelp to make HTML files and a Devhelp project\"\n\t@echo \" epub to make an epub\"\n\t@echo \" epub3 to make an epub3\"\n\t@echo \" latex to make LaTeX files, you can set PAPER=a4 or PAPER=letter\"\n\t@echo \" latexpdf to make LaTeX files and run them through pdflatex\"\n\t@echo \" latexpdfja to make LaTeX files and run them through platex/dvipdfmx\"\n\t@echo \" text to make text files\"\n\t@echo \" man to make manual pages\"\n\t@echo \" texinfo to make Texinfo files\"\n\t@echo \" info to make Texinfo files and run them through makeinfo\"\n\t@echo \" gettext to make PO message catalogs\"\n\t@echo \" changes to make an overview of all changed/added/deprecated items\"\n\t@echo \" xml to make Docutils-native XML files\"\n\t@echo \" pseudoxml to make pseudoxml-XML files for display purposes\"\n\t@echo \" linkcheck to check all external links for integrity\"\n\t@echo \" doctest to run all doctests embedded in the documentation (if enabled)\"\n\t@echo \" coverage to run coverage check of the documentation (if enabled)\"\n\t@echo \" dummy to check syntax errors of document sources\"\n\n.PHONY: clean\nclean:\n\trm -rf $(BUILDDIR)/*\n\n.PHONY: html\nhtml:\n\t$(SPHINXBUILD) -b html $(ALLSPHINXOPTS) $(BUILDDIR)/html\n\t@echo\n\t@echo \"Build finished. The HTML pages are in $(BUILDDIR)/html.\"\n\n.PHONY: dirhtml\ndirhtml:\n\t$(SPHINXBUILD) -b dirhtml $(ALLSPHINXOPTS) $(BUILDDIR)/dirhtml\n\t@echo\n\t@echo \"Build finished. The HTML pages are in $(BUILDDIR)/dirhtml.\"\n\n.PHONY: singlehtml\nsinglehtml:\n\t$(SPHINXBUILD) -b singlehtml $(ALLSPHINXOPTS) $(BUILDDIR)/singlehtml\n\t@echo\n\t@echo \"Build finished. The HTML page is in $(BUILDDIR)/singlehtml.\"\n\n.PHONY: pickle\npickle:\n\t$(SPHINXBUILD) -b pickle $(ALLSPHINXOPTS) $(BUILDDIR)/pickle\n\t@echo\n\t@echo \"Build finished; now you can process the pickle files.\"\n\n.PHONY: json\njson:\n\t$(SPHINXBUILD) -b json $(ALLSPHINXOPTS) $(BUILDDIR)/json\n\t@echo\n\t@echo \"Build finished; now you can process the JSON files.\"\n\n.PHONY: htmlhelp\nhtmlhelp:\n\t$(SPHINXBUILD) -b htmlhelp $(ALLSPHINXOPTS) $(BUILDDIR)/htmlhelp\n\t@echo\n\t@echo \"Build finished; now you can run HTML Help Workshop with the\" \\\n\t \".hhp project file in $(BUILDDIR)/htmlhelp.\"\n\n.PHONY: qthelp\nqthelp:\n\t$(SPHINXBUILD) -b qthelp $(ALLSPHINXOPTS) $(BUILDDIR)/qthelp\n\t@echo\n\t@echo \"Build finished; now you can run \"qcollectiongenerator\" with the\" \\\n\t \".qhcp project file in $(BUILDDIR)/qthelp, like this:\"\n\t@echo \"# qcollectiongenerator $(BUILDDIR)/qthelp/aiographite.qhcp\"\n\t@echo \"To view the help file:\"\n\t@echo \"# assistant -collectionFile $(BUILDDIR)/qthelp/aiographite.qhc\"\n\n.PHONY: applehelp\napplehelp:\n\t$(SPHINXBUILD) -b applehelp $(ALLSPHINXOPTS) $(BUILDDIR)/applehelp\n\t@echo\n\t@echo \"Build finished. The help book is in $(BUILDDIR)/applehelp.\"\n\t@echo \"N.B. You won't be able to view it unless you put it in\" \\\n\t \"~/Library/Documentation/Help or install it in your application\" \\\n\t \"bundle.\"\n\n.PHONY: devhelp\ndevhelp:\n\t$(SPHINXBUILD) -b devhelp $(ALLSPHINXOPTS) $(BUILDDIR)/devhelp\n\t@echo\n\t@echo \"Build finished.\"\n\t@echo \"To view the help file:\"\n\t@echo \"# mkdir -p $$HOME/.local/share/devhelp/aiographite\"\n\t@echo \"# ln -s $(BUILDDIR)/devhelp $$HOME/.local/share/devhelp/aiographite\"\n\t@echo \"# devhelp\"\n\n.PHONY: epub\nepub:\n\t$(SPHINXBUILD) -b epub $(ALLSPHINXOPTS) $(BUILDDIR)/epub\n\t@echo\n\t@echo \"Build finished. The epub file is in $(BUILDDIR)/epub.\"\n\n.PHONY: epub3\nepub3:\n\t$(SPHINXBUILD) -b epub3 $(ALLSPHINXOPTS) $(BUILDDIR)/epub3\n\t@echo\n\t@echo \"Build finished. The epub3 file is in $(BUILDDIR)/epub3.\"\n\n.PHONY: latex\nlatex:\n\t$(SPHINXBUILD) -b latex $(ALLSPHINXOPTS) $(BUILDDIR)/latex\n\t@echo\n\t@echo \"Build finished; the LaTeX files are in $(BUILDDIR)/latex.\"\n\t@echo \"Run \\`make' in that directory to run these through (pdf)latex\" \\\n\t \"(use \\`make latexpdf' here to do that automatically).\"\n\n.PHONY: latexpdf\nlatexpdf:\n\t$(SPHINXBUILD) -b latex $(ALLSPHINXOPTS) $(BUILDDIR)/latex\n\t@echo \"Running LaTeX files through pdflatex...\"\n\t$(MAKE) -C $(BUILDDIR)/latex all-pdf\n\t@echo \"pdflatex finished; the PDF files are in $(BUILDDIR)/latex.\"\n\n.PHONY: latexpdfja\nlatexpdfja:\n\t$(SPHINXBUILD) -b latex $(ALLSPHINXOPTS) $(BUILDDIR)/latex\n\t@echo \"Running LaTeX files through platex and dvipdfmx...\"\n\t$(MAKE) -C $(BUILDDIR)/latex all-pdf-ja\n\t@echo \"pdflatex finished; the PDF files are in $(BUILDDIR)/latex.\"\n\n.PHONY: text\ntext:\n\t$(SPHINXBUILD) -b text $(ALLSPHINXOPTS) $(BUILDDIR)/text\n\t@echo\n\t@echo \"Build finished. The text files are in $(BUILDDIR)/text.\"\n\n.PHONY: man\nman:\n\t$(SPHINXBUILD) -b man $(ALLSPHINXOPTS) $(BUILDDIR)/man\n\t@echo\n\t@echo \"Build finished. The manual pages are in $(BUILDDIR)/man.\"\n\n.PHONY: texinfo\ntexinfo:\n\t$(SPHINXBUILD) -b texinfo $(ALLSPHINXOPTS) $(BUILDDIR)/texinfo\n\t@echo\n\t@echo \"Build finished. The Texinfo files are in $(BUILDDIR)/texinfo.\"\n\t@echo \"Run \\`make' in that directory to run these through makeinfo\" \\\n\t \"(use \\`make info' here to do that automatically).\"\n\n.PHONY: info\ninfo:\n\t$(SPHINXBUILD) -b texinfo $(ALLSPHINXOPTS) $(BUILDDIR)/texinfo\n\t@echo \"Running Texinfo files through makeinfo...\"\n\tmake -C $(BUILDDIR)/texinfo info\n\t@echo \"makeinfo finished; the Info files are in $(BUILDDIR)/texinfo.\"\n\n.PHONY: gettext\ngettext:\n\t$(SPHINXBUILD) -b gettext $(I18NSPHINXOPTS) $(BUILDDIR)/locale\n\t@echo\n\t@echo \"Build finished. The message catalogs are in $(BUILDDIR)/locale.\"\n\n.PHONY: changes\nchanges:\n\t$(SPHINXBUILD) -b changes $(ALLSPHINXOPTS) $(BUILDDIR)/changes\n\t@echo\n\t@echo \"The overview file is in $(BUILDDIR)/changes.\"\n\n.PHONY: linkcheck\nlinkcheck:\n\t$(SPHINXBUILD) -b linkcheck $(ALLSPHINXOPTS) $(BUILDDIR)/linkcheck\n\t@echo\n\t@echo \"Link check complete; look for any errors in the above output \" \\\n\t \"or in $(BUILDDIR)/linkcheck/output.txt.\"\n\n.PHONY: doctest\ndoctest:\n\t$(SPHINXBUILD) -b doctest $(ALLSPHINXOPTS) $(BUILDDIR)/doctest\n\t@echo \"Testing of doctests in the sources finished, look at the \" \\\n\t \"results in $(BUILDDIR)/doctest/output.txt.\"\n\n.PHONY: coverage\ncoverage:\n\t$(SPHINXBUILD) -b coverage $(ALLSPHINXOPTS) $(BUILDDIR)/coverage\n\t@echo \"Testing of coverage in the sources finished, look at the \" \\\n\t \"results in $(BUILDDIR)/coverage/python.txt.\"\n\n.PHONY: xml\nxml:\n\t$(SPHINXBUILD) -b xml $(ALLSPHINXOPTS) $(BUILDDIR)/xml\n\t@echo\n\t@echo \"Build finished. The XML files are in $(BUILDDIR)/xml.\"\n\n.PHONY: pseudoxml\npseudoxml:\n\t$(SPHINXBUILD) -b pseudoxml $(ALLSPHINXOPTS) $(BUILDDIR)/pseudoxml\n\t@echo\n\t@echo \"Build finished. The pseudo-XML files are in $(BUILDDIR)/pseudoxml.\"\n\n.PHONY: dummy\ndummy:\n\t$(SPHINXBUILD) -b dummy $(ALLSPHINXOPTS) $(BUILDDIR)/dummy\n\t@echo\n\t@echo \"Build finished. Dummy builder generates no files.\"\n" }, { "path": "docs/_static/.gitkeep", "content": "" }, { "path": "docs/_static/custom.css", "content": ".wy-side-nav-search,\n.wy-nav-top {\n background: #444444;\n}\n\n#changelog section {\n padding-left: 3rem;\n}\n\n#changelog section h2,\n#changelog section h3 {\n margin-left: -3rem;\n}\n" }, { "path": "docs/_templates/banner.html", "content": "
\n

This is a banner!

\n
\n" }, { "path": "docs/conf.py", "content": "#!/usr/bin/env python3\n# -*- coding: utf-8 -*-\n#\n# Sanic documentation build configuration file, created by\n# sphinx-quickstart on Sun Dec 25 18:07:21 2016.\n#\n# This file is execfile()d with the current directory set to its\n# containing dir.\n\nimport os\nimport sys\n\n\n# Add support for auto-doc\n\n\n# Ensure that sanic is present in the path, to allow sphinx-apidoc to\n# autogenerate documentation from docstrings\nroot_directory = os.path.dirname(os.getcwd())\nsys.path.insert(0, root_directory)\n\nimport sanic # noqa\n\n\n# -- General configuration ------------------------------------------------\n\nextensions = [\n \"sphinx.ext.autodoc\",\n \"m2r2\",\n \"enum_tools.autoenum\",\n]\n\ntemplates_path = [\"_templates\"]\n\n# Enable support for both Restructured Text and Markdown\nsource_suffix = [\".rst\", \".md\"]\n\n# The master toctree document.\nmaster_doc = \"index\"\n\n# General information about the project.\nproject = \"Sanic\"\ncopyright = \"2021, Sanic Community Organization\"\nauthor = \"Sanic Community Organization\"\n\nhtml_logo = \"./_static/sanic-framework-logo-white-400x97.png\"\n# The version info for the project you're documenting, acts as replacement for\n# |version| and |release|, also used in various other places throughout the\n# built documents.\n#\n# The short X.Y version.\nversion = sanic.__version__\n# The full version, including alpha/beta/rc tags.\nrelease = sanic.__version__\n\n# The language for content autogenerated by Sphinx. Refer to documentation\n# for a list of supported languages.\n#\n# This is also used if you do content translation via gettext catalogs.\n# Usually you set \"language\" from the command line for these cases.\nlanguage = \"en\"\n\n# List of patterns, relative to source directory, that match files and\n# directories to ignore when looking for source files.\n# This patterns also effect to html_static_path and html_extra_path\n#\n# modules.rst is generated by sphinx-apidoc but is unused. This suppresses\n# a warning about it.\nexclude_patterns = [\"_build\", \"Thumbs.db\", \".DS_Store\", \"modules.rst\"]\n\n# The name of the Pygments (syntax highlighting) style to use.\npygments_style = \"sphinx\"\n\n# If true, `todo` and `todoList` produce output, else they produce nothing.\ntodo_include_todos = False\n\n# -- Options for HTML output ----------------------------------------------\n\n# The theme to use for HTML and HTML Help pages. See the documentation for\n# a list of builtin themes.\nhtml_theme = \"sphinx_rtd_theme\"\n\n# Add any paths that contain custom static files (such as style sheets) here,\n# relative to this directory. They are copied after the builtin static files,\n# so a file named \"default.css\" will overwrite the builtin \"default.css\".\nhtml_static_path = [\"_static\"]\nhtml_css_files = [\"custom.css\"]\n# -- Options for HTMLHelp output ------------------------------------------\n\n# Output file base name for HTML help builder.\nhtmlhelp_basename = \"Sanicdoc\"\n\n# -- Options for LaTeX output ---------------------------------------------\n\nlatex_elements = {\n # The paper size ('letterpaper' or 'a4paper').\n #\n # 'papersize': 'letterpaper',\n # The font size ('10pt', '11pt' or '12pt').\n #\n # 'pointsize': '10pt',\n # Additional stuff for the LaTeX preamble.\n #\n # 'preamble': '',\n # Latex figure (float) alignment\n #\n # 'figure_align': 'htbp',\n}\n\n# Grouping the document tree into LaTeX files. List of tuples\n# (source start file, target name, title,\n# author, documentclass [howto, manual, or own class]).\nlatex_documents = [\n (\n master_doc,\n \"Sanic.tex\",\n \"Sanic Documentation\",\n \"Sanic contributors\",\n \"manual\",\n ),\n]\n\n# -- Options for manual page output ---------------------------------------\n\n# One entry per manual page. List of tuples\n# (source start file, name, description, authors, manual section).\nman_pages = [(master_doc, \"sanic\", \"Sanic Documentation\", [author], 1)]\n\n# -- Options for Texinfo output -------------------------------------------\n\n# Grouping the document tree into Texinfo files. List of tuples\n# (source start file, target name, title, author,\n# dir menu entry, description, category)\ntexinfo_documents = [\n (\n master_doc,\n \"Sanic\",\n \"Sanic Documentation\",\n author,\n \"Sanic\",\n \"One line description of project.\",\n \"Miscellaneous\",\n ),\n]\n\n# -- Options for Epub output ----------------------------------------------\n\n# Bibliographic Dublin Core info.\nepub_title = project\nepub_author = author\nepub_publisher = author\nepub_copyright = copyright\n\n# A list of files that should not be packed into the epub file.\nepub_exclude_files = [\"search.html\"]\n\n# -- Custom Settings -------------------------------------------------------\n\nsuppress_warnings = [\"image.nonlocal_uri\"]\n\n\nautodoc_typehints = \"description\"\nautodoc_default_options = {\n \"member-order\": \"groupwise\",\n}\n\nhtml_theme_options = {\n \"style_external_links\": False,\n}\n\nrst_prolog = \"\"\".. warning::\n These documents are **OUTDATED** as of 2023-12-31.\n\n Please refer to the latest version of the documentation at `sanic.dev `__.\n\"\"\"\n" }, { "path": "docs/index.html", "content": "\n\n\n\n\n\nindex.rst\n\n\n\n
\n\n\n
\n

Sanic

\n

Sanic is a Python 3.6+ web server and web framework that's written to go fast. It allows the usage of the async/await syntax added in Python 3.5, which makes your code non-blocking and speedy.

\n

The goal of the project is to provide a simple way to get up and running a highly performant HTTP server that is easy to build, to expand, and ultimately to scale.

\n

Sanic is developed on GitHub. Contributions are welcome!

\n
\n

Sanic aspires to be simple

\n
\nfrom sanic import Sanic\nfrom sanic.response import json\n\napp = Sanic()\n\n@app.route("/")\nasync def test(request):\n    return json({"hello": "world"})\n\nif __name__ == "__main__":\n    app.run(host="0.0.0.0", port=8000)\n
\n
\n

Note

\n

Sanic does not support Python 3.5 from version 19.6 and forward. However, version 18.12LTS is supported thru\nDecember 2020. Official Python support for version 3.5 is set to expire in September 2020.

\n
\n
\n
\n
\n

Guides

\n
\n

System Message: ERROR/3 (E:/OneDrive/GitHub/sanic/docs/index.rst, line 6)

\n

Unknown directive type "toctree".

\n
\n.. toctree::\n   :maxdepth: 2\n\n   sanic/getting_started\n   sanic/config\n   sanic/logging\n   sanic/request_data\n   sanic/response\n   sanic/cookies\n   sanic/routing\n   sanic/blueprints\n   sanic/static_files\n   sanic/versioning\n   sanic/exceptions\n   sanic/middleware\n   sanic/websocket\n   sanic/decorators\n   sanic/streaming\n   sanic/class_based_views\n   sanic/custom_protocol\n   sanic/sockets\n   sanic/ssl\n   sanic/debug_mode\n   sanic/testing\n   sanic/deploying\n   sanic/extensions\n   sanic/examples\n   sanic/changelog\n   sanic/contributing\n   sanic/api_reference\n   sanic/asyncio_python37\n\n\n
\n
\n
\n
\n

Module Documentation

\n
\n

System Message: ERROR/3 (E:/OneDrive/GitHub/sanic/docs/index.rst, line 42)

\n

Unknown directive type "toctree".

\n
\n.. toctree::\n\n
\n
\n
    \n

  • :ref:`genindex`

    \n
    \n

    System Message: ERROR/3 (E:/OneDrive/GitHub/sanic/docs/index.rst, line 44); backlink

    \n

    Unknown interpreted text role "ref".

    \n
    \n
    • \n

  • :ref:`modindex`

    \n
    \n

    System Message: ERROR/3 (E:/OneDrive/GitHub/sanic/docs/index.rst, line 45); backlink

    \n

    Unknown interpreted text role "ref".

    \n
    \n
    • \n

  • :ref:`search`

    \n
    \n

    System Message: ERROR/3 (E:/OneDrive/GitHub/sanic/docs/index.rst, line 46); backlink

    \n

    Unknown interpreted text role "ref".

    \n
    \n
    • \n
\n
\n
\n\n\n" }, { "path": "docs/index.rst", "content": ".. include:: ../README.rst\n\nUser Guide\n==========\n\nTo learn about using Sanic, checkout the `User Guide `__.\n\nAPI\n===\n\n.. toctree::\n :maxdepth: 3\n\n 👥 User Guide \n sanic/api_reference\n 💻 Source code \n sanic/changelog\n sanic/contributing\n ❓ Support \n 💬 Chat \n\n\nModule Documentation\n====================\n\n.. toctree::\n\n* :ref:`genindex`\n* :ref:`modindex`\n" }, { "path": "docs/make.bat", "content": "@ECHO OFF\n\nREM Command file for Sphinx documentation\n\nif \"%SPHINXBUILD%\" == \"\" (\n\tset SPHINXBUILD=sphinx-build\n)\nset BUILDDIR=_build\nset ALLSPHINXOPTS=-d %BUILDDIR%/doctrees %SPHINXOPTS% .\nset I18NSPHINXOPTS=%SPHINXOPTS% .\nif NOT \"%PAPER%\" == \"\" (\n\tset ALLSPHINXOPTS=-D latex_paper_size=%PAPER% %ALLSPHINXOPTS%\n\tset I18NSPHINXOPTS=-D latex_paper_size=%PAPER% %I18NSPHINXOPTS%\n)\n\nif \"%1\" == \"\" goto help\n\nif \"%1\" == \"help\" (\n\t:help\n\techo.Please use `make ^` where ^ is one of\n\techo. html to make standalone HTML files\n\techo. dirhtml to make HTML files named index.html in directories\n\techo. singlehtml to make a single large HTML file\n\techo. pickle to make pickle files\n\techo. json to make JSON files\n\techo. htmlhelp to make HTML files and a HTML help project\n\techo. qthelp to make HTML files and a qthelp project\n\techo. devhelp to make HTML files and a Devhelp project\n\techo. epub to make an epub\n\techo. epub3 to make an epub3\n\techo. latex to make LaTeX files, you can set PAPER=a4 or PAPER=letter\n\techo. text to make text files\n\techo. man to make manual pages\n\techo. texinfo to make Texinfo files\n\techo. gettext to make PO message catalogs\n\techo. changes to make an overview over all changed/added/deprecated items\n\techo. xml to make Docutils-native XML files\n\techo. pseudoxml to make pseudoxml-XML files for display purposes\n\techo. linkcheck to check all external links for integrity\n\techo. doctest to run all doctests embedded in the documentation if enabled\n\techo. coverage to run coverage check of the documentation if enabled\n\techo. dummy to check syntax errors of document sources\n\tgoto end\n)\n\nif \"%1\" == \"clean\" (\n\tfor /d %%i in (%BUILDDIR%\\*) do rmdir /q /s %%i\n\tdel /q /s %BUILDDIR%\\*\n\tgoto end\n)\n\n\nREM Check if sphinx-build is available and fallback to Python version if any\n%SPHINXBUILD% 1>NUL 2>NUL\nif errorlevel 9009 goto sphinx_python\ngoto sphinx_ok\n\n:sphinx_python\n\nset SPHINXBUILD=python -m sphinx.__init__\n%SPHINXBUILD% 2> nul\nif errorlevel 9009 (\n\techo.\n\techo.The 'sphinx-build' command was not found. Make sure you have Sphinx\n\techo.installed, then set the SPHINXBUILD environment variable to point\n\techo.to the full path of the 'sphinx-build' executable. Alternatively you\n\techo.may add the Sphinx directory to PATH.\n\techo.\n\techo.If you don't have Sphinx installed, grab it from\n\techo.http://sphinx-doc.org/\n\texit /b 1\n)\n\n:sphinx_ok\n\n\nif \"%1\" == \"html\" (\n\t%SPHINXBUILD% -b html %ALLSPHINXOPTS% %BUILDDIR%/html\n\tif errorlevel 1 exit /b 1\n\techo.\n\techo.Build finished. The HTML pages are in %BUILDDIR%/html.\n\tgoto end\n)\n\nif \"%1\" == \"dirhtml\" (\n\t%SPHINXBUILD% -b dirhtml %ALLSPHINXOPTS% %BUILDDIR%/dirhtml\n\tif errorlevel 1 exit /b 1\n\techo.\n\techo.Build finished. The HTML pages are in %BUILDDIR%/dirhtml.\n\tgoto end\n)\n\nif \"%1\" == \"singlehtml\" (\n\t%SPHINXBUILD% -b singlehtml %ALLSPHINXOPTS% %BUILDDIR%/singlehtml\n\tif errorlevel 1 exit /b 1\n\techo.\n\techo.Build finished. The HTML pages are in %BUILDDIR%/singlehtml.\n\tgoto end\n)\n\nif \"%1\" == \"pickle\" (\n\t%SPHINXBUILD% -b pickle %ALLSPHINXOPTS% %BUILDDIR%/pickle\n\tif errorlevel 1 exit /b 1\n\techo.\n\techo.Build finished; now you can process the pickle files.\n\tgoto end\n)\n\nif \"%1\" == \"json\" (\n\t%SPHINXBUILD% -b json %ALLSPHINXOPTS% %BUILDDIR%/json\n\tif errorlevel 1 exit /b 1\n\techo.\n\techo.Build finished; now you can process the JSON files.\n\tgoto end\n)\n\nif \"%1\" == \"htmlhelp\" (\n\t%SPHINXBUILD% -b htmlhelp %ALLSPHINXOPTS% %BUILDDIR%/htmlhelp\n\tif errorlevel 1 exit /b 1\n\techo.\n\techo.Build finished; now you can run HTML Help Workshop with the ^\n.hhp project file in %BUILDDIR%/htmlhelp.\n\tgoto end\n)\n\nif \"%1\" == \"qthelp\" (\n\t%SPHINXBUILD% -b qthelp %ALLSPHINXOPTS% %BUILDDIR%/qthelp\n\tif errorlevel 1 exit /b 1\n\techo.\n\techo.Build finished; now you can run \"qcollectiongenerator\" with the ^\n.qhcp project file in %BUILDDIR%/qthelp, like this:\n\techo.^> qcollectiongenerator %BUILDDIR%\\qthelp\\aiographite.qhcp\n\techo.To view the help file:\n\techo.^> assistant -collectionFile %BUILDDIR%\\qthelp\\aiographite.ghc\n\tgoto end\n)\n\nif \"%1\" == \"devhelp\" (\n\t%SPHINXBUILD% -b devhelp %ALLSPHINXOPTS% %BUILDDIR%/devhelp\n\tif errorlevel 1 exit /b 1\n\techo.\n\techo.Build finished.\n\tgoto end\n)\n\nif \"%1\" == \"epub\" (\n\t%SPHINXBUILD% -b epub %ALLSPHINXOPTS% %BUILDDIR%/epub\n\tif errorlevel 1 exit /b 1\n\techo.\n\techo.Build finished. The epub file is in %BUILDDIR%/epub.\n\tgoto end\n)\n\nif \"%1\" == \"epub3\" (\n\t%SPHINXBUILD% -b epub3 %ALLSPHINXOPTS% %BUILDDIR%/epub3\n\tif errorlevel 1 exit /b 1\n\techo.\n\techo.Build finished. The epub3 file is in %BUILDDIR%/epub3.\n\tgoto end\n)\n\nif \"%1\" == \"latex\" (\n\t%SPHINXBUILD% -b latex %ALLSPHINXOPTS% %BUILDDIR%/latex\n\tif errorlevel 1 exit /b 1\n\techo.\n\techo.Build finished; the LaTeX files are in %BUILDDIR%/latex.\n\tgoto end\n)\n\nif \"%1\" == \"latexpdf\" (\n\t%SPHINXBUILD% -b latex %ALLSPHINXOPTS% %BUILDDIR%/latex\n\tcd %BUILDDIR%/latex\n\tmake all-pdf\n\tcd %~dp0\n\techo.\n\techo.Build finished; the PDF files are in %BUILDDIR%/latex.\n\tgoto end\n)\n\nif \"%1\" == \"latexpdfja\" (\n\t%SPHINXBUILD% -b latex %ALLSPHINXOPTS% %BUILDDIR%/latex\n\tcd %BUILDDIR%/latex\n\tmake all-pdf-ja\n\tcd %~dp0\n\techo.\n\techo.Build finished; the PDF files are in %BUILDDIR%/latex.\n\tgoto end\n)\n\nif \"%1\" == \"text\" (\n\t%SPHINXBUILD% -b text %ALLSPHINXOPTS% %BUILDDIR%/text\n\tif errorlevel 1 exit /b 1\n\techo.\n\techo.Build finished. The text files are in %BUILDDIR%/text.\n\tgoto end\n)\n\nif \"%1\" == \"man\" (\n\t%SPHINXBUILD% -b man %ALLSPHINXOPTS% %BUILDDIR%/man\n\tif errorlevel 1 exit /b 1\n\techo.\n\techo.Build finished. The manual pages are in %BUILDDIR%/man.\n\tgoto end\n)\n\nif \"%1\" == \"texinfo\" (\n\t%SPHINXBUILD% -b texinfo %ALLSPHINXOPTS% %BUILDDIR%/texinfo\n\tif errorlevel 1 exit /b 1\n\techo.\n\techo.Build finished. The Texinfo files are in %BUILDDIR%/texinfo.\n\tgoto end\n)\n\nif \"%1\" == \"gettext\" (\n\t%SPHINXBUILD% -b gettext %I18NSPHINXOPTS% %BUILDDIR%/locale\n\tif errorlevel 1 exit /b 1\n\techo.\n\techo.Build finished. The message catalogs are in %BUILDDIR%/locale.\n\tgoto end\n)\n\nif \"%1\" == \"changes\" (\n\t%SPHINXBUILD% -b changes %ALLSPHINXOPTS% %BUILDDIR%/changes\n\tif errorlevel 1 exit /b 1\n\techo.\n\techo.The overview file is in %BUILDDIR%/changes.\n\tgoto end\n)\n\nif \"%1\" == \"linkcheck\" (\n\t%SPHINXBUILD% -b linkcheck %ALLSPHINXOPTS% %BUILDDIR%/linkcheck\n\tif errorlevel 1 exit /b 1\n\techo.\n\techo.Link check complete; look for any errors in the above output ^\nor in %BUILDDIR%/linkcheck/output.txt.\n\tgoto end\n)\n\nif \"%1\" == \"doctest\" (\n\t%SPHINXBUILD% -b doctest %ALLSPHINXOPTS% %BUILDDIR%/doctest\n\tif errorlevel 1 exit /b 1\n\techo.\n\techo.Testing of doctests in the sources finished, look at the ^\nresults in %BUILDDIR%/doctest/output.txt.\n\tgoto end\n)\n\nif \"%1\" == \"coverage\" (\n\t%SPHINXBUILD% -b coverage %ALLSPHINXOPTS% %BUILDDIR%/coverage\n\tif errorlevel 1 exit /b 1\n\techo.\n\techo.Testing of coverage in the sources finished, look at the ^\nresults in %BUILDDIR%/coverage/python.txt.\n\tgoto end\n)\n\nif \"%1\" == \"xml\" (\n\t%SPHINXBUILD% -b xml %ALLSPHINXOPTS% %BUILDDIR%/xml\n\tif errorlevel 1 exit /b 1\n\techo.\n\techo.Build finished. The XML files are in %BUILDDIR%/xml.\n\tgoto end\n)\n\nif \"%1\" == \"pseudoxml\" (\n\t%SPHINXBUILD% -b pseudoxml %ALLSPHINXOPTS% %BUILDDIR%/pseudoxml\n\tif errorlevel 1 exit /b 1\n\techo.\n\techo.Build finished. The pseudo-XML files are in %BUILDDIR%/pseudoxml.\n\tgoto end\n)\n\nif \"%1\" == \"dummy\" (\n\t%SPHINXBUILD% -b dummy %ALLSPHINXOPTS% %BUILDDIR%/dummy\n\tif errorlevel 1 exit /b 1\n\techo.\n\techo.Build finished. Dummy builder generates no files.\n\tgoto end\n)\n\n:end\n" }, { "path": "docs/sanic/api/app.rst", "content": "Application\n===========\n\nsanic.app\n---------\n\n.. automodule:: sanic.app\n :members:\n :show-inheritance:\n :inherited-members:\n\nsanic.config\n------------\n\n.. automodule:: sanic.config\n :members:\n :show-inheritance:\n\nsanic.application.constants\n---------------------------\n\n.. automodule:: sanic.application.constants\n :exclude-members: StrEnum\n :members:\n :show-inheritance:\n :inherited-members:\n\nsanic.application.state\n-----------------------\n\n.. automodule:: sanic.application.state\n :members:\n :show-inheritance:\n" }, { "path": "docs/sanic/api/blueprints.rst", "content": "Blueprints\n==========\n\nsanic.blueprints\n----------------\n\n.. automodule:: sanic.blueprints\n :members:\n :show-inheritance:\n :inherited-members:\n\nsanic.blueprint_group\n---------------------\n\n.. automodule:: sanic.blueprint_group\n :members:\n :special-members:\n" }, { "path": "docs/sanic/api/core.rst", "content": "Core\n====\n\nsanic.cookies\n-------------\n\n.. automodule:: sanic.cookies\n :members:\n :show-inheritance:\n\n\nsanic.handlers\n--------------\n\n.. automodule:: sanic.handlers\n :members:\n :show-inheritance:\n\n\nsanic.headers\n--------------\n\n.. automodule:: sanic.headers\n :members:\n :show-inheritance:\n\n\nsanic.request\n-------------\n\n.. automodule:: sanic.request\n :members:\n :show-inheritance:\n\nsanic.response\n--------------\n\n.. automodule:: sanic.response\n :members:\n :show-inheritance:\n\n\nsanic.views\n-----------\n\n.. automodule:: sanic.views\n :members:\n :show-inheritance:\n" }, { "path": "docs/sanic/api/exceptions.rst", "content": "Exceptions\n==========\n\nsanic.errorpages\n----------------\n\n.. automodule:: sanic.errorpages\n :members:\n :show-inheritance:\n\nsanic.exceptions\n----------------\n\n.. automodule:: sanic.exceptions\n :members:\n :show-inheritance:\n" }, { "path": "docs/sanic/api/router.rst", "content": "Routing\n=======\n\nsanic_routing models\n--------------------\n\n.. autoclass:: sanic_routing.route::Route\n :members:\n\n.. autoclass:: sanic_routing.group::RouteGroup\n :members:\n\nsanic.router\n------------\n\n.. automodule:: sanic.router\n :members:\n :show-inheritance:\n" }, { "path": "docs/sanic/api/server.rst", "content": "Sanic Server\n============\n\nsanic.http\n----------\n\n.. automodule:: sanic.http\n :members:\n :show-inheritance:\n\n\nsanic.server\n------------\n\n.. automodule:: sanic.server\n :members:\n :show-inheritance:\n\n" }, { "path": "docs/sanic/api/utility.rst", "content": "Utility\n=======\n\nsanic.compat\n------------\n\n.. automodule:: sanic.compat\n :members:\n :show-inheritance:\n\nsanic.log\n---------\n\n.. automodule:: sanic.log\n :members:\n :show-inheritance:\n" }, { "path": "docs/sanic/api_reference.rst", "content": "📑 API Reference\n================\n\n.. toctree::\n :maxdepth: 2\n\n api/app\n api/blueprints\n api/core\n api/exceptions\n api/router\n api/server\n api/utility\n" }, { "path": "docs/sanic/changelog.rst", "content": "📜 Changelog\n============\n\n| 🔶 Current release\n| 🔷 In support release\n|\n\n.. mdinclude:: ./releases/23/23.6.md\n.. mdinclude:: ./releases/23/23.3.md\n.. mdinclude:: ./releases/22/22.12.md\n.. mdinclude:: ./releases/22/22.9.md\n.. mdinclude:: ./releases/22/22.6.md\n.. mdinclude:: ./releases/22/22.3.md\n.. mdinclude:: ./releases/21/21.12.md\n.. mdinclude:: ./releases/21/21.9.md\n.. include:: ../../CHANGELOG.rst\n" }, { "path": "docs/sanic/contributing.rst", "content": "♥️ Contributing\n===============\n\n.. include:: ../../CONTRIBUTING.rst\n" }, { "path": "docs/sanic/releases/21/21.12.md", "content": "## Version 21.12.1 🔷\n\n_Current LTS version_\n\n- [#2349](https://github.com/sanic-org/sanic/pull/2349) Only display MOTD on startup\n- [#2354](https://github.com/sanic-org/sanic/pull/2354) Ignore name argument in Python 3.7\n- [#2355](https://github.com/sanic-org/sanic/pull/2355) Add config.update support for all config values\n\n## Version 21.12.0 🔹\n\n### Features\n- [#2260](https://github.com/sanic-org/sanic/pull/2260) Allow early Blueprint registrations to still apply later added objects\n- [#2262](https://github.com/sanic-org/sanic/pull/2262) Noisy exceptions - force logging of all exceptions\n- [#2264](https://github.com/sanic-org/sanic/pull/2264) Optional `uvloop` by configuration\n- [#2270](https://github.com/sanic-org/sanic/pull/2270) Vhost support using multiple TLS certificates\n- [#2277](https://github.com/sanic-org/sanic/pull/2277) Change signal routing for increased consistency\n - *BREAKING CHANGE*: If you were manually routing signals there is a breaking change. The signal router's `get` is no longer 100% determinative. There is now an additional step to loop thru the returned signals for proper matching on the requirements. If signals are being dispatched using `app.dispatch` or `bp.dispatch`, there is no change.\n- [#2290](https://github.com/sanic-org/sanic/pull/2290) Add contextual exceptions\n- [#2291](https://github.com/sanic-org/sanic/pull/2291) Increase join concat performance \n- [#2295](https://github.com/sanic-org/sanic/pull/2295), [#2316](https://github.com/sanic-org/sanic/pull/2316), [#2331](https://github.com/sanic-org/sanic/pull/2331) Restructure of CLI and application state with new displays and more command parity with `app.run`\n- [#2302](https://github.com/sanic-org/sanic/pull/2302) Add route context at definition time\n- [#2304](https://github.com/sanic-org/sanic/pull/2304) Named tasks and new API for managing background tasks\n- [#2307](https://github.com/sanic-org/sanic/pull/2307) On app auto-reload, provide insight of changed files\n- [#2308](https://github.com/sanic-org/sanic/pull/2308) Auto extend application with [Sanic Extensions](https://sanicframework.org/en/plugins/sanic-ext/getting-started.html) if it is installed, and provide first class support for accessing the extensions\n- [#2309](https://github.com/sanic-org/sanic/pull/2309) Builtin signals changed to `Enum`\n- [#2313](https://github.com/sanic-org/sanic/pull/2313) Support additional config implementation use case\n- [#2321](https://github.com/sanic-org/sanic/pull/2321) Refactor environment variable hydration logic\n- [#2327](https://github.com/sanic-org/sanic/pull/2327) Prevent sending multiple or mixed responses on a single request\n- [#2330](https://github.com/sanic-org/sanic/pull/2330) Custom type casting on environment variables\n- [#2332](https://github.com/sanic-org/sanic/pull/2332) Make all deprecation notices consistent\n- [#2335](https://github.com/sanic-org/sanic/pull/2335) Allow underscore to start instance names\n\n### Bugfixes\n- [#2273](https://github.com/sanic-org/sanic/pull/2273) Replace assignation by typing for `websocket_handshake`\n- [#2285](https://github.com/sanic-org/sanic/pull/2285) Fix IPv6 display in startup logs\n- [#2299](https://github.com/sanic-org/sanic/pull/2299) Dispatch `http.lifecyle.response` from exception handler\n\n### Deprecations and Removals\n- [#2306](https://github.com/sanic-org/sanic/pull/2306) Removal of deprecated items\n - `Sanic` and `Blueprint` may no longer have arbitrary properties attached to them\n - `Sanic` and `Blueprint` forced to have compliant names\n - alphanumeric + `_` + `-`\n - must start with letter or `_`\n - `load_env` keyword argument of `Sanic`\n - `sanic.exceptions.abort`\n - `sanic.views.CompositionView`\n - `sanic.response.StreamingHTTPResponse`\n - *NOTE:* the `stream()` response method (where you pass a callable streaming function) has been deprecated and will be removed in v22.6. You should upgrade all streaming responses to the new style: https://sanicframework.org/en/guide/advanced/streaming.html#response-streaming\n- [#2320](https://github.com/sanic-org/sanic/pull/2320) Remove app instance from Config for error handler setting\n\n### Developer infrastructure\n- [#2251](https://github.com/sanic-org/sanic/pull/2251) Change dev install command\n- [#2286](https://github.com/sanic-org/sanic/pull/2286) Change codeclimate complexity threshold from 5 to 10\n- [#2287](https://github.com/sanic-org/sanic/pull/2287) Update host test function names so they are not overwritten\n- [#2292](https://github.com/sanic-org/sanic/pull/2292) Fail CI on error\n- [#2311](https://github.com/sanic-org/sanic/pull/2311), [#2324](https://github.com/sanic-org/sanic/pull/2324) Do not run tests for draft PRs\n- [#2336](https://github.com/sanic-org/sanic/pull/2336) Remove paths from coverage checks\n- [#2338](https://github.com/sanic-org/sanic/pull/2338) Cleanup ports on tests\n\n### Improved Documentation\n- [#2269](https://github.com/sanic-org/sanic/pull/2269), [#2329](https://github.com/sanic-org/sanic/pull/2329), [#2333](https://github.com/sanic-org/sanic/pull/2333) Cleanup typos and fix language\n\n### Miscellaneous\n- [#2257](https://github.com/sanic-org/sanic/pull/2257), [#2294](https://github.com/sanic-org/sanic/pull/2294), [#2341](https://github.com/sanic-org/sanic/pull/2341) Add Python 3.10 support\n- [#2279](https://github.com/sanic-org/sanic/pull/2279), [#2317](https://github.com/sanic-org/sanic/pull/2317), [#2322](https://github.com/sanic-org/sanic/pull/2322) Add/correct missing type annotations\n- [#2305](https://github.com/sanic-org/sanic/pull/2305) Fix examples to use modern implementations\n" }, { "path": "docs/sanic/releases/21/21.9.md", "content": "## Version 21.9.3\n*Rerelease of v21.9.2 with some cleanup*\n\n## Version 21.9.2\n- [#2268](https://github.com/sanic-org/sanic/pull/2268) Make HTTP connections start in IDLE stage, avoiding delays and error messages\n- [#2310](https://github.com/sanic-org/sanic/pull/2310) More consistent config setting with post-FALLBACK_ERROR_FORMAT apply\n\n## Version 21.9.1\n- [#2259](https://github.com/sanic-org/sanic/pull/2259) Allow non-conforming ErrorHandlers\n\n## Version 21.9.0\n\n### Features\n- [#2158](https://github.com/sanic-org/sanic/pull/2158), [#2248](https://github.com/sanic-org/sanic/pull/2248) Complete overhaul of I/O to websockets\n- [#2160](https://github.com/sanic-org/sanic/pull/2160) Add new 17 signals into server and request lifecycles\n- [#2162](https://github.com/sanic-org/sanic/pull/2162) Smarter `auto` fallback formatting upon exception\n- [#2184](https://github.com/sanic-org/sanic/pull/2184) Introduce implementation for copying a Blueprint\n- [#2200](https://github.com/sanic-org/sanic/pull/2200) Accept header parsing\n- [#2207](https://github.com/sanic-org/sanic/pull/2207) Log remote address if available\n- [#2209](https://github.com/sanic-org/sanic/pull/2209) Add convenience methods to BP groups\n- [#2216](https://github.com/sanic-org/sanic/pull/2216) Add default messages to SanicExceptions\n- [#2225](https://github.com/sanic-org/sanic/pull/2225) Type annotation convenience for annotated handlers with path parameters\n- [#2236](https://github.com/sanic-org/sanic/pull/2236) Allow Falsey (but not-None) responses from route handlers\n- [#2238](https://github.com/sanic-org/sanic/pull/2238) Add `exception` decorator to Blueprint Groups\n- [#2244](https://github.com/sanic-org/sanic/pull/2244) Explicit static directive for serving file or dir (ex: `static(..., resource_type=\"file\")`)\n- [#2245](https://github.com/sanic-org/sanic/pull/2245) Close HTTP loop when connection task cancelled\n\n### Bugfixes\n- [#2188](https://github.com/sanic-org/sanic/pull/2188) Fix the handling of the end of a chunked request\n- [#2195](https://github.com/sanic-org/sanic/pull/2195) Resolve unexpected error handling on static requests\n- [#2208](https://github.com/sanic-org/sanic/pull/2208) Make blueprint-based exceptions attach and trigger in a more intuitive manner\n- [#2211](https://github.com/sanic-org/sanic/pull/2211) Fixed for handling exceptions of asgi app call\n- [#2213](https://github.com/sanic-org/sanic/pull/2213) Fix bug where ws exceptions not being logged\n- [#2231](https://github.com/sanic-org/sanic/pull/2231) Cleaner closing of tasks by using `abort()` in strategic places to avoid dangling sockets\n- [#2247](https://github.com/sanic-org/sanic/pull/2247) Fix logging of auto-reload status in debug mode\n- [#2246](https://github.com/sanic-org/sanic/pull/2246) Account for BP with exception handler but no routes\n\n### Developer infrastructure \n- [#2194](https://github.com/sanic-org/sanic/pull/2194) HTTP unit tests with raw client\n- [#2199](https://github.com/sanic-org/sanic/pull/2199) Switch to codeclimate\n- [#2214](https://github.com/sanic-org/sanic/pull/2214) Try Reopening Windows Tests\n- [#2229](https://github.com/sanic-org/sanic/pull/2229) Refactor `HttpProtocol` into a base class\n- [#2230](https://github.com/sanic-org/sanic/pull/2230) Refactor `server.py` into multi-file module\n\n### Miscellaneous\n- [#2173](https://github.com/sanic-org/sanic/pull/2173) Remove Duplicated Dependencies and PEP 517 Support \n- [#2193](https://github.com/sanic-org/sanic/pull/2193), [#2196](https://github.com/sanic-org/sanic/pull/2196), [#2217](https://github.com/sanic-org/sanic/pull/2217) Type annotation changes\n\n\n\n" }, { "path": "docs/sanic/releases/22/22.12.md", "content": "## Version 22.12.0 🔷\n\n_Current version_\n\n### Features\n\n- [#2569](https://github.com/sanic-org/sanic/pull/2569) Add `JSONResponse` class with some convenient methods when updating a response object\n- [#2598](https://github.com/sanic-org/sanic/pull/2598) Change `uvloop` requirement to `>=0.15.0`\n- [#2609](https://github.com/sanic-org/sanic/pull/2609) Add compatibility with `websockets` v11.0\n- [#2610](https://github.com/sanic-org/sanic/pull/2610) Kill server early on worker error\n - Raise deadlock timeout to 30s\n- [#2617](https://github.com/sanic-org/sanic/pull/2617) Scale number of running server workers\n- [#2621](https://github.com/sanic-org/sanic/pull/2621) [#2634](https://github.com/sanic-org/sanic/pull/2634) Send `SIGKILL` on subsequent `ctrl+c` to force worker exit\n- [#2622](https://github.com/sanic-org/sanic/pull/2622) Add API to restart all workers from the multiplexer\n- [#2624](https://github.com/sanic-org/sanic/pull/2624) Default to `spawn` for all subprocesses unless specifically set:\n ```python\n from sanic import Sanic\n \n Sanic.start_method = \"fork\"\n ```\n- [#2625](https://github.com/sanic-org/sanic/pull/2625) Filename normalisation of form-data/multipart file uploads\n- [#2626](https://github.com/sanic-org/sanic/pull/2626) Move to HTTP Inspector:\n - Remote access to inspect running Sanic instances\n - TLS support for encrypted calls to Inspector\n - Authentication to Inspector with API key\n - Ability to extend Inspector with custom commands\n- [#2632](https://github.com/sanic-org/sanic/pull/2632) Control order of restart operations\n- [#2633](https://github.com/sanic-org/sanic/pull/2633) Move reload interval to class variable\n- [#2636](https://github.com/sanic-org/sanic/pull/2636) Add `priority` to `register_middleware` method\n- [#2639](https://github.com/sanic-org/sanic/pull/2639) Add `unquote` to `add_route` method\n- [#2640](https://github.com/sanic-org/sanic/pull/2640) ASGI websockets to receive `text` or `bytes`\n\n\n### Bugfixes\n\n- [#2607](https://github.com/sanic-org/sanic/pull/2607) Force socket shutdown before close to allow rebinding\n- [#2590](https://github.com/sanic-org/sanic/pull/2590) Use actual `StrEnum` in Python 3.11+\n- [#2615](https://github.com/sanic-org/sanic/pull/2615) Ensure middleware executes only once per request timeout\n- [#2627](https://github.com/sanic-org/sanic/pull/2627) Crash ASGI application on lifespan failure\n- [#2635](https://github.com/sanic-org/sanic/pull/2635) Resolve error with low-level server creation on Windows\n\n\n### Deprecations and Removals\n\n- [#2608](https://github.com/sanic-org/sanic/pull/2608) [#2630](https://github.com/sanic-org/sanic/pull/2630) Signal conditions and triggers saved on `signal.extra` \n- [#2626](https://github.com/sanic-org/sanic/pull/2626) Move to HTTP Inspector\n - 🚨 *BREAKING CHANGE*: Moves the Inspector to a Sanic app from a simple TCP socket with a custom protocol\n - *DEPRECATE*: The `--inspect*` commands have been deprecated in favor of `inspect ...` commands\n- [#2628](https://github.com/sanic-org/sanic/pull/2628) Replace deprecated `distutils.strtobool`\n\n\n### Developer infrastructure\n\n- [#2612](https://github.com/sanic-org/sanic/pull/2612) Add CI testing for Python 3.11\n\n" }, { "path": "docs/sanic/releases/22/22.3.md", "content": "## Version 22.3.0\n\n### Features\n- [#2347](https://github.com/sanic-org/sanic/pull/2347) API for multi-application server\n - 🚨 *BREAKING CHANGE*: The old `sanic.worker.GunicornWorker` has been **removed**. To run Sanic with `gunicorn`, you should use it thru `uvicorn` [as described in their docs](https://www.uvicorn.org/#running-with-gunicorn).\n - 🧁 *SIDE EFFECT*: Named background tasks are now supported, even in Python 3.7\n- [#2357](https://github.com/sanic-org/sanic/pull/2357) Parse `Authorization` header as `Request.credentials`\n- [#2361](https://github.com/sanic-org/sanic/pull/2361) Add config option to skip `Touchup` step in application startup\n- [#2372](https://github.com/sanic-org/sanic/pull/2372) Updates to CLI help messaging\n- [#2382](https://github.com/sanic-org/sanic/pull/2382) Downgrade warnings to backwater debug messages \n- [#2396](https://github.com/sanic-org/sanic/pull/2396) Allow for `multidict` v0.6\n- [#2401](https://github.com/sanic-org/sanic/pull/2401) Upgrade CLI catching for alternative application run types\n- [#2402](https://github.com/sanic-org/sanic/pull/2402) Conditionally inject CLI arguments into factory\n- [#2413](https://github.com/sanic-org/sanic/pull/2413) Add new start and stop event listeners to reloader process\n- [#2414](https://github.com/sanic-org/sanic/pull/2414) Remove loop as required listener arg\n- [#2415](https://github.com/sanic-org/sanic/pull/2415) Better exception for bad URL parsing\n- [sanic-routing#47](https://github.com/sanic-org/sanic-routing/pull/47) Add a new extention parameter type: ``, ``, ``, ``, ``, ``\n - 👶 *BETA FEATURE*: This feature will not work with `path` type matching, and is being released as a beta feature only.\n- [sanic-routing#57](https://github.com/sanic-org/sanic-routing/pull/57) Change `register_pattern` to accept a `str` or `Pattern`\n- [sanic-routing#58](https://github.com/sanic-org/sanic-routing/pull/58) Default matching on non-empty strings only, and new `strorempty` pattern type\n - 🚨 *BREAKING CHANGE*: Previously a route with a dynamic string parameter (`/` or `/`) would match on any string, including empty strings. It will now **only** match a non-empty string. To retain the old behavior, you should use the new parameter type: `/`.\n\n### Bugfixes\n- [#2373](https://github.com/sanic-org/sanic/pull/2373) Remove `error_logger` on websockets\n- [#2381](https://github.com/sanic-org/sanic/pull/2381) Fix newly assigned `None` in task registry\n- [sanic-routing#52](https://github.com/sanic-org/sanic-routing/pull/52) Add type casting to regex route matching\n- [sanic-routing#60](https://github.com/sanic-org/sanic-routing/pull/60) Add requirements check on regex routes (this resolves, for example, multiple static directories with differing `host` values)\n\n### Deprecations and Removals\n- [#2362](https://github.com/sanic-org/sanic/pull/2362) 22.3 Deprecations and changes\n 1. `debug=True` and `--debug` do _NOT_ automatically run `auto_reload`\n 2. Default error render is with plain text (browsers still get HTML by default because `auto` looks at headers)\n 3. `config` is required for `ErrorHandler.finalize`\n 4. `ErrorHandler.lookup` requires two positional args\n 5. Unused websocket protocol args removed\n- [#2344](https://github.com/sanic-org/sanic/pull/2344) Deprecate loading of lowercase environment variables\n\n### Developer infrastructure\n- [#2363](https://github.com/sanic-org/sanic/pull/2363) Revert code coverage back to Codecov\n- [#2405](https://github.com/sanic-org/sanic/pull/2405) Upgrade tests for `sanic-routing` changes\n- [sanic-testing#35](https://github.com/sanic-org/sanic-testing/pull/35) Allow for httpx v0.22\n\n### Improved Documentation\n- [#2350](https://github.com/sanic-org/sanic/pull/2350) Fix link in README for ASGI\n- [#2398](https://github.com/sanic-org/sanic/pull/2398) Document middleware on_request and on_response\n- [#2409](https://github.com/sanic-org/sanic/pull/2409) Add missing documentation for `Request.respond`\n\n### Miscellaneous\n- [#2376](https://github.com/sanic-org/sanic/pull/2376) Fix typing for `ListenerMixin.listener`\n- [#2383](https://github.com/sanic-org/sanic/pull/2383) Clear deprecation warning in `asyncio.wait`\n- [#2387](https://github.com/sanic-org/sanic/pull/2387) Cleanup `__slots__` implementations\n- [#2390](https://github.com/sanic-org/sanic/pull/2390) Clear deprecation warning in `asyncio.get_event_loop`\n" }, { "path": "docs/sanic/releases/22/22.6.md", "content": "## Version 22.6.2\n\n### Bugfixes\n\n- [#2522](https://github.com/sanic-org/sanic/pull/2522) Always show server location in ASGI\n\n## Version 22.6.1\n\n### Bugfixes\n\n- [#2477](https://github.com/sanic-org/sanic/pull/2477) Sanic static directory fails when folder name ends with \"..\"\n\n\n## Version 22.6.0\n\n### Features\n- [#2378](https://github.com/sanic-org/sanic/pull/2378) Introduce HTTP/3 and autogeneration of TLS certificates in `DEBUG` mode\n - 👶 *EARLY RELEASE FEATURE*: Serving Sanic over HTTP/3 is an early release feature. It does not yet fully cover the HTTP/3 spec, but instead aims for feature parity with Sanic's existing HTTP/1.1 server. Websockets, WebTransport, push responses are examples of some features not yet implemented.\n - 📦 *EXTRA REQUIREMENT*: Not all HTTP clients are capable of interfacing with HTTP/3 servers. You may need to install a [HTTP/3 capable client](https://curl.se/docs/http3.html).\n - 📦 *EXTRA REQUIREMENT*: In order to use TLS autogeneration, you must install either [mkcert](https://github.com/FiloSottile/mkcert) or [trustme](https://github.com/python-trio/trustme).\n- [#2416](https://github.com/sanic-org/sanic/pull/2416) Add message to `task.cancel`\n- [#2420](https://github.com/sanic-org/sanic/pull/2420) Add exception aliases for more consistent naming with standard HTTP response types (`BadRequest`, `MethodNotAllowed`, `RangeNotSatisfiable`)\n- [#2432](https://github.com/sanic-org/sanic/pull/2432) Expose ASGI `scope` as a property on the `Request` object\n- [#2438](https://github.com/sanic-org/sanic/pull/2438) Easier access to websocket class for annotation: `from sanic import Websocket`\n- [#2439](https://github.com/sanic-org/sanic/pull/2439) New API for reading form values with options: `Request.get_form` \n- [#2445](https://github.com/sanic-org/sanic/pull/2445) Add custom `loads` function\n- [#2447](https://github.com/sanic-org/sanic/pull/2447), [#2486](https://github.com/sanic-org/sanic/pull/2486) Improved API to support setting cache control headers\n- [#2453](https://github.com/sanic-org/sanic/pull/2453) Move verbosity filtering to logger\n- [#2475](https://github.com/sanic-org/sanic/pull/2475) Expose getter for current request using `Request.get_current()`\n\n### Bugfixes\n- [#2448](https://github.com/sanic-org/sanic/pull/2448) Fix to allow running with `pythonw.exe` or places where there is no `sys.stdout`\n- [#2451](https://github.com/sanic-org/sanic/pull/2451) Trigger `http.lifecycle.request` signal in ASGI mode\n- [#2455](https://github.com/sanic-org/sanic/pull/2455) Resolve typing of stacked route definitions\n- [#2463](https://github.com/sanic-org/sanic/pull/2463) Properly catch websocket CancelledError in websocket handler in Python 3.7\n\n### Deprecations and Removals\n- [#2487](https://github.com/sanic-org/sanic/pull/2487) v22.6 deprecations and changes\n 1. Optional application registry\n 1. Execution of custom handlers after some part of response was sent\n 1. Configuring fallback handlers on the `ErrorHandler`\n 1. Custom `LOGO` setting\n 1. `sanic.response.stream`\n 1. `AsyncioServer.init`\n\n### Developer infrastructure\n- [#2449](https://github.com/sanic-org/sanic/pull/2449) Clean up `black` and `isort` config\n- [#2479](https://github.com/sanic-org/sanic/pull/2479) Fix some flappy tests\n\n### Improved Documentation\n- [#2461](https://github.com/sanic-org/sanic/pull/2461) Update example to match current application naming standards\n- [#2466](https://github.com/sanic-org/sanic/pull/2466) Better type annotation for `Extend`\n- [#2485](https://github.com/sanic-org/sanic/pull/2485) Improved help messages in CLI\n\n" }, { "path": "docs/sanic/releases/22/22.9.md", "content": "## Version 22.9.1\n\n### Features\n\n- [#2585](https://github.com/sanic-org/sanic/pull/2585) Improved error message when no applications have been registered\n\n\n### Bugfixes\n\n- [#2578](https://github.com/sanic-org/sanic/pull/2578) Add certificate loader for in process certificate creation\n- [#2591](https://github.com/sanic-org/sanic/pull/2591) Do not use sentinel identity for `spawn` compatibility\n- [#2592](https://github.com/sanic-org/sanic/pull/2592) Fix properties in nested blueprint groups\n- [#2595](https://github.com/sanic-org/sanic/pull/2595) Introduce sleep interval on new worker reloader\n\n\n### Deprecations and Removals\n\n\n### Developer infrastructure\n\n- [#2588](https://github.com/sanic-org/sanic/pull/2588) Markdown templates on issue forms\n\n\n### Improved Documentation\n\n- [#2556](https://github.com/sanic-org/sanic/pull/2556) v22.9 documentation\n- [#2582](https://github.com/sanic-org/sanic/pull/2582) Cleanup documentation on Windows support\n\n\n## Version 22.9.0\n\n### Features\n\n- [#2445](https://github.com/sanic-org/sanic/pull/2445) Add custom loads function \n- [#2490](https://github.com/sanic-org/sanic/pull/2490) Make `WebsocketImplProtocol` async iterable\n- [#2499](https://github.com/sanic-org/sanic/pull/2499) Sanic Server WorkerManager refactor\n- [#2506](https://github.com/sanic-org/sanic/pull/2506) Use `pathlib` for path resolution (for static file serving)\n- [#2508](https://github.com/sanic-org/sanic/pull/2508) Use `path.parts` instead of `match` (for static file serving)\n- [#2513](https://github.com/sanic-org/sanic/pull/2513) Better request cancel handling\n- [#2516](https://github.com/sanic-org/sanic/pull/2516) Add request properties for HTTP method info:\n - `request.is_safe`\n - `request.is_idempotent`\n - `request.is_cacheable`\n - *See* [MDN docs](https://developer.mozilla.org/en-US/docs/Web/HTTP/Methods) *for more information about when these apply*\n- [#2522](https://github.com/sanic-org/sanic/pull/2522) Always show server location in ASGI\n- [#2526](https://github.com/sanic-org/sanic/pull/2526) Cache control support for static files for returning 304 when appropriate\n- [#2533](https://github.com/sanic-org/sanic/pull/2533) Refactor `_static_request_handler`\n- [#2540](https://github.com/sanic-org/sanic/pull/2540) Add signals before and after handler execution\n - `http.handler.before`\n - `http.handler.after`\n- [#2542](https://github.com/sanic-org/sanic/pull/2542) Add *[redacted]* to CLI :)\n- [#2546](https://github.com/sanic-org/sanic/pull/2546) Add deprecation warning filter\n- [#2550](https://github.com/sanic-org/sanic/pull/2550) Middleware priority and performance enhancements\n\n### Bugfixes\n\n- [#2495](https://github.com/sanic-org/sanic/pull/2495) Prevent directory traversion with static files\n- [#2515](https://github.com/sanic-org/sanic/pull/2515) Do not apply double slash to paths in certain static dirs in Blueprints\n\n### Deprecations and Removals\n\n- [#2525](https://github.com/sanic-org/sanic/pull/2525) Warn on duplicate route names, will be prevented outright in v23.3\n- [#2537](https://github.com/sanic-org/sanic/pull/2537) Raise warning and deprecation notice on duplicate exceptions, will be prevented outright in v23.3\n\n### Developer infrastructure\n\n- [#2504](https://github.com/sanic-org/sanic/pull/2504) Cleanup test suite\n- [#2505](https://github.com/sanic-org/sanic/pull/2505) Replace Unsupported Python Version Number from the Contributing Doc\n- [#2530](https://github.com/sanic-org/sanic/pull/2530) Do not include tests folder in installed package resolver\n\n### Improved Documentation\n\n- [#2502](https://github.com/sanic-org/sanic/pull/2502) Fix a few typos\n- [#2517](https://github.com/sanic-org/sanic/pull/2517) [#2536](https://github.com/sanic-org/sanic/pull/2536) Add some type hints\n" }, { "path": "docs/sanic/releases/23/23.3.md", "content": "## Version 23.3.0\n\n### Features\n- [#2545](https://github.com/sanic-org/sanic/pull/2545) Standardize init of exceptions for more consistent control of HTTP responses using exceptions\n- [#2606](https://github.com/sanic-org/sanic/pull/2606) Decode headers as UTF-8 also in ASGI\n- [#2646](https://github.com/sanic-org/sanic/pull/2646) Separate ASGI request and lifespan callables\n- [#2659](https://github.com/sanic-org/sanic/pull/2659) Use ``FALLBACK_ERROR_FORMAT`` for handlers that return ``empty()``\n- [#2662](https://github.com/sanic-org/sanic/pull/2662) Add basic file browser (HTML page) and auto-index serving\n- [#2667](https://github.com/sanic-org/sanic/pull/2667) Nicer traceback formatting (HTML page)\n- [#2668](https://github.com/sanic-org/sanic/pull/2668) Smarter error page rendering format selection; more reliant upon header and \"common sense\" defaults\n- [#2680](https://github.com/sanic-org/sanic/pull/2680) Check the status of socket before shutting down with ``SHUT_RDWR``\n- [#2687](https://github.com/sanic-org/sanic/pull/2687) Refresh ``Request.accept`` functionality to be more performant and spec-compliant\n- [#2696](https://github.com/sanic-org/sanic/pull/2696) Add header accessors as properties\n ```\n Example-Field: Foo, Bar\n Example-Field: Baz\n ```\n ```python\n request.headers.example_field == \"Foo, Bar,Baz\"\n ```\n- [#2700](https://github.com/sanic-org/sanic/pull/2700) Simpler CLI targets\n\n ```sh\n $ sanic path.to.module:app # global app instance\n $ sanic path.to.module:create_app # factory pattern\n $ sanic ./path/to/directory/ # simple serve\n ```\n- [#2701](https://github.com/sanic-org/sanic/pull/2701) API to define a number of workers in managed processes\n- [#2704](https://github.com/sanic-org/sanic/pull/2704) Add convenience for dynamic changes to routing\n- [#2706](https://github.com/sanic-org/sanic/pull/2706) Add convenience methods for cookie creation and deletion\n \n ```python\n response = text(\"...\")\n response.add_cookie(\"test\", \"It worked!\", domain=\".yummy-yummy-cookie.com\")\n ```\n- [#2707](https://github.com/sanic-org/sanic/pull/2707) Simplified ``parse_content_header`` escaping to be RFC-compliant and remove outdated FF hack\n- [#2710](https://github.com/sanic-org/sanic/pull/2710) Stricter charset handling and escaping of request URLs\n- [#2711](https://github.com/sanic-org/sanic/pull/2711) Consume body on ``DELETE`` by default\n- [#2719](https://github.com/sanic-org/sanic/pull/2719) Allow ``password`` to be passed to TLS context\n- [#2720](https://github.com/sanic-org/sanic/pull/2720) Skip middleware on ``RequestCancelled``\n- [#2721](https://github.com/sanic-org/sanic/pull/2721) Change access logging format to ``%s``\n- [#2722](https://github.com/sanic-org/sanic/pull/2722) Add ``CertLoader`` as application option for directly controlling ``SSLContext`` objects\n- [#2725](https://github.com/sanic-org/sanic/pull/2725) Worker sync state tolerance on race condition\n\n### Bugfixes\n- [#2651](https://github.com/sanic-org/sanic/pull/2651) ASGI websocket to pass thru bytes as is\n- [#2697](https://github.com/sanic-org/sanic/pull/2697) Fix comparison between datetime aware and naive in ``file`` when using ``If-Modified-Since``\n\n### Deprecations and Removals\n- [#2666](https://github.com/sanic-org/sanic/pull/2666) Remove deprecated ``__blueprintname__`` property\n\n### Improved Documentation\n- [#2712](https://github.com/sanic-org/sanic/pull/2712) Improved example using ``'https'`` to create the redirect\n" }, { "path": "docs/sanic/releases/23/23.6.md", "content": "## Version 23.6.0 🔶\n\n### Features\n- [#2670](https://github.com/sanic-org/sanic/pull/2670) Increase `KEEP_ALIVE_TIMEOUT` default to 120 seconds\n- [#2716](https://github.com/sanic-org/sanic/pull/2716) Adding allow route overwrite option in blueprint\n- [#2724](https://github.com/sanic-org/sanic/pull/2724) and [#2792](https://github.com/sanic-org/sanic/pull/2792) Add a new exception signal for ALL exceptions raised anywhere in application\n- [#2727](https://github.com/sanic-org/sanic/pull/2727) Add name prefixing to BP groups\n- [#2754](https://github.com/sanic-org/sanic/pull/2754) Update request type on middleware types\n- [#2770](https://github.com/sanic-org/sanic/pull/2770) Better exception message on startup time application induced import error\n- [#2776](https://github.com/sanic-org/sanic/pull/2776) Set multiprocessing start method early\n- [#2785](https://github.com/sanic-org/sanic/pull/2785) Add custom typing to config and ctx objects\n- [#2790](https://github.com/sanic-org/sanic/pull/2790) Add `request.client_ip`\n\n### Bugfixes\n- [#2728](https://github.com/sanic-org/sanic/pull/2728) Fix traversals for intended results\n- [#2729](https://github.com/sanic-org/sanic/pull/2729) Handle case when headers argument of ResponseStream constructor is None\n- [#2737](https://github.com/sanic-org/sanic/pull/2737) Fix type annotation for `JSONREsponse` default content type\n- [#2740](https://github.com/sanic-org/sanic/pull/2740) Use Sanic's serializer for JSON responses in the Inspector\n- [#2760](https://github.com/sanic-org/sanic/pull/2760) Support for `Request.get_current` in ASGI mode\n- [#2773](https://github.com/sanic-org/sanic/pull/2773) Alow Blueprint routes to explicitly define error_format\n- [#2774](https://github.com/sanic-org/sanic/pull/2774) Resolve headers on different renderers\n- [#2782](https://github.com/sanic-org/sanic/pull/2782) Resolve pypy compatibility issues\n\n### Deprecations and Removals\n- [#2777](https://github.com/sanic-org/sanic/pull/2777) Remove Python 3.7 support\n\n### Developer infrastructure\n- [#2766](https://github.com/sanic-org/sanic/pull/2766) Unpin setuptools version\n- [#2779](https://github.com/sanic-org/sanic/pull/2779) Run keep alive tests in loop to get available port\n\n### Improved Documentation\n- [#2741](https://github.com/sanic-org/sanic/pull/2741) Better documentation examples about running Sanic\nFrom that list, the items to highlight in the release notes:\n" }, { "path": "examples/Dockerfile", "content": "FROM sanicframework/sanic:LTS\n\nRUN mkdir /srv\nCOPY . /srv\n\nWORKDIR /srv\n\nCMD [\"sanic\", \"simple_server.app\"]\n" }, { "path": "examples/add_task_sanic.py", "content": "# -*- coding: utf-8 -*-\n\nimport asyncio\n\nfrom sanic import Sanic\n\n\napp = Sanic(\"Example\")\n\n\nasync def notify_server_started_after_five_seconds():\n await asyncio.sleep(5)\n print(\"Server successfully started!\")\n\n\napp.add_task(notify_server_started_after_five_seconds())\n\nif __name__ == \"__main__\":\n app.run(host=\"0.0.0.0\", port=8000)\n" }, { "path": "examples/amending_request_object.py", "content": "from random import randint\n\nfrom sanic import Sanic\nfrom sanic.response import text\n\n\napp = Sanic(\"Example\")\n\n\n@app.middleware(\"request\")\ndef append_request(request):\n request.ctx.num = randint(0, 100)\n\n\n@app.get(\"/pop\")\ndef pop_handler(request):\n return text(request.ctx.num)\n\n\n@app.get(\"/key_exist\")\ndef key_exist_handler(request):\n # Check the key is exist or not\n if hasattr(request.ctx, \"num\"):\n return text(\"num exist in request\")\n\n return text(\"num does not exist in request\")\n\n\nif __name__ == \"__main__\":\n app.run(host=\"0.0.0.0\", port=8000, debug=True)\n" }, { "path": "examples/authorized_sanic.py", "content": "# -*- coding: utf-8 -*-\n\nfrom functools import wraps\n\nfrom sanic import Sanic\nfrom sanic.response import json\n\n\napp = Sanic(\"Example\")\n\n\ndef check_request_for_authorization_status(request):\n # Note: Define your check, for instance cookie, session.\n flag = True\n return flag\n\n\ndef authorized(f):\n @wraps(f)\n async def decorated_function(request, *args, **kwargs):\n # run some method that checks the request\n # for the client's authorization status\n is_authorized = check_request_for_authorization_status(request)\n\n if is_authorized:\n # the user is authorized.\n # run the handler method and return the response\n response = await f(request, *args, **kwargs)\n return response\n else:\n # the user is not authorized.\n return json({\"status\": \"not_authorized\"}, 403)\n\n return decorated_function\n\n\n@app.route(\"/\")\n@authorized\nasync def test(request):\n return json({\"status\": \"authorized\"})\n\n\nif __name__ == \"__main__\":\n app.run(host=\"0.0.0.0\", port=8000)\n" }, { "path": "examples/blueprint_middlware_execution_order.py", "content": "from sanic import Blueprint, Sanic\nfrom sanic.response import text\n\n\n\"\"\"\nDemonstrates that blueprint request middleware are executed in the order they\nare added. And blueprint response middleware are executed in _reverse_ order.\nOn a valid request, it should print \"1 2 3 6 5 4\" to terminal\n\"\"\"\n\napp = Sanic(\"Example\")\n\nbp = Blueprint(\"bp_example\")\n\n\n@bp.on_request\ndef request_middleware_1(request):\n print(\"1\")\n\n\n@bp.on_request\ndef request_middleware_2(request):\n print(\"2\")\n\n\n@bp.on_request\ndef request_middleware_3(request):\n print(\"3\")\n\n\n@bp.on_response\ndef resp_middleware_4(request, response):\n print(\"4\")\n\n\n@bp.on_response\ndef resp_middleware_5(request, response):\n print(\"5\")\n\n\n@bp.on_response\ndef resp_middleware_6(request, response):\n print(\"6\")\n\n\n@bp.route(\"/\")\ndef pop_handler(request):\n return text(\"hello world\")\n\n\napp.blueprint(bp, url_prefix=\"/bp\")\n\nif __name__ == \"__main__\":\n app.run(host=\"0.0.0.0\", port=8000, debug=True, auto_reload=False)\n" }, { "path": "examples/blueprints.py", "content": "from sanic import Blueprint, Sanic\nfrom sanic.response import file, json\n\n\napp = Sanic(\"Example\")\nblueprint = Blueprint(\"bp_example\", url_prefix=\"/my_blueprint\")\nblueprint2 = Blueprint(\"bp_example2\", url_prefix=\"/my_blueprint2\")\nblueprint3 = Blueprint(\"bp_example3\", url_prefix=\"/my_blueprint3\")\n\n\n@blueprint.route(\"/foo\")\nasync def foo(request):\n return json({\"msg\": \"hi from blueprint\"})\n\n\n@blueprint2.route(\"/foo\")\nasync def foo2(request):\n return json({\"msg\": \"hi from blueprint2\"})\n\n\n@blueprint3.route(\"/foo\")\nasync def index(request):\n return await file(\"websocket.html\")\n\n\n@app.websocket(\"/feed\")\nasync def foo3(request, ws):\n while True:\n data = \"hello!\"\n print(\"Sending: \" + data)\n await ws.send(data)\n data = await ws.recv()\n print(\"Received: \" + data)\n\n\napp.blueprint(blueprint)\napp.blueprint(blueprint2)\napp.blueprint(blueprint3)\n\nif __name__ == \"__main__\":\n app.run(host=\"0.0.0.0\", port=9999, debug=True)\n" }, { "path": "examples/delayed_response.py", "content": "from asyncio import sleep\n\nfrom sanic import Sanic, response\n\n\napp = Sanic(\"DelayedResponseApp\", strict_slashes=True)\napp.config.AUTO_EXTEND = False\n\n\n@app.get(\"/\")\nasync def handler(request):\n return response.redirect(\"/sleep/3\")\n\n\n@app.get(\"/sleep/\")\nasync def handler2(request, t=0.3):\n await sleep(t)\n return response.text(f\"Slept {t:.1f} seconds.\\n\")\n\n\nif __name__ == \"__main__\":\n app.run(host=\"0.0.0.0\", port=8000)\n" }, { "path": "examples/docker-compose.yml", "content": "version: '2'\nservices:\n sanic:\n build: .\n ports:\n - \"8000:8000\"" }, { "path": "examples/exception_monitoring.py", "content": "\"\"\"\nExample intercepting uncaught exceptions using Sanic's error handler framework.\nThis may be useful for developers wishing to use Sentry, Airbrake, etc.\nor a custom system to log and monitor unexpected errors in production.\nFirst we create our own class inheriting from Handler in sanic.exceptions,\nand pass in an instance of it when we create our Sanic instance. Inside this\nclass' default handler, we can do anything including sending exceptions to\nan external service.\n\"\"\"\n\nfrom sanic import Sanic\nfrom sanic.exceptions import SanicException\nfrom sanic.handlers import ErrorHandler\n\n\n\"\"\"\nImports and code relevant for our CustomHandler class\n(Ordinarily this would be in a separate file)\n\"\"\"\n\n\nclass CustomHandler(ErrorHandler):\n def default(self, request, exception):\n # Here, we have access to the exception object\n # and can do anything with it (log, send to external service, etc)\n\n # Some exceptions are trivial and built into Sanic (404s, etc)\n if not isinstance(exception, SanicException):\n print(exception)\n\n # Then, we must finish handling the exception by returning\n # our response to the client\n # For this we can just call the super class' default handler\n return super().default(request, exception)\n\n\n\"\"\"\nThis is an ordinary Sanic server, with the exception that we set the\nserver's error_handler to an instance of our CustomHandler\n\"\"\"\n\n\nhandler = CustomHandler()\napp = Sanic(\"Example\", error_handler=handler)\n\n\n@app.route(\"/\")\nasync def test(request):\n # Here, something occurs which causes an unexpected exception\n # This exception will flow to our custom handler.\n raise SanicException(\"You Broke It!\")\n\n\nif __name__ == \"__main__\":\n app.run(host=\"0.0.0.0\", port=8000, debug=True)\n" }, { "path": "examples/hello_world.py", "content": "from sanic import Sanic, response\n\n\napp = Sanic(\"Example\")\n\n\n@app.route(\"/\")\nasync def test(request):\n return response.json({\"test\": True})\n\n\nif __name__ == \"__main__\":\n app.run(host=\"0.0.0.0\", port=8000)\n" }, { "path": "examples/http_redirect.py", "content": "from sanic import Sanic, response, text\nfrom sanic.handlers import ErrorHandler\nfrom sanic.server.async_server import AsyncioServer\n\n\nHTTP_PORT = 9999\nHTTPS_PORT = 8888\n\nhttp = Sanic(\"http\")\nhttp.config.SERVER_NAME = f\"localhost:{HTTP_PORT}\"\nhttps = Sanic(\"https\")\nhttps.config.SERVER_NAME = f\"localhost:{HTTPS_PORT}\"\n\n\n@https.get(\"/foo\")\ndef foo(request):\n return text(\"foo\")\n\n\n@https.get(\"/bar\")\ndef bar(request):\n return text(\"bar\")\n\n\n@http.get(\"/\")\ndef proxy(request, path):\n url = request.app.url_for(\n \"proxy\",\n path=path,\n _server=https.config.SERVER_NAME,\n _external=True,\n _scheme=\"https\",\n )\n return response.redirect(url)\n\n\n@https.main_process_start\nasync def start(app, _):\n http_server = await http.create_server(\n port=HTTP_PORT, return_asyncio_server=True\n )\n app.add_task(runner(http, http_server))\n app.ctx.http_server = http_server\n app.ctx.http = http\n\n\n@https.main_process_stop\nasync def stop(app, _):\n await app.ctx.http_server.before_stop()\n await app.ctx.http_server.close()\n for connection in app.ctx.http_server.connections:\n connection.close_if_idle()\n await app.ctx.http_server.after_stop()\n app.ctx.http = False\n\n\nasync def runner(app: Sanic, app_server: AsyncioServer):\n app.is_running = True\n try:\n app.signalize()\n app.finalize()\n ErrorHandler.finalize(app.error_handler)\n app_server.init = True\n\n await app_server.before_start()\n await app_server.after_start()\n await app_server.serve_forever()\n finally:\n app.is_running = False\n app.is_stopping = True\n\n\nif __name__ == \"__main__\":\n https.run(port=HTTPS_PORT, debug=True)\n" }, { "path": "examples/limit_concurrency.py", "content": "import asyncio\n\nimport httpx\n\nfrom sanic import Sanic\nfrom sanic.response import json\n\n\napp = Sanic(\"Example\")\n\nsem = None\n\n\n@app.before_server_start\ndef init(sanic, _):\n global sem\n concurrency_per_worker = 4\n sem = asyncio.Semaphore(concurrency_per_worker)\n\n\nasync def bounded_fetch(session, url):\n \"\"\"\n Use session object to perform 'get' request on url\n \"\"\"\n async with sem:\n response = await session.get(url)\n return response.json()\n\n\n@app.route(\"/\")\nasync def test(request):\n \"\"\"\n Download and serve example JSON\n \"\"\"\n url = \"https://api.github.com/repos/sanic-org/sanic\"\n\n async with httpx.AsyncClient() as session:\n response = await bounded_fetch(session, url)\n return json(response)\n\n\nif __name__ == \"__main__\":\n app.run(host=\"0.0.0.0\", port=8000, workers=2)\n" }, { "path": "examples/log_request_id.py", "content": "import logging\n\nfrom contextvars import ContextVar\n\nfrom sanic import Sanic, response\n\n\nlog = logging.getLogger(__name__)\n\n\nclass RequestIdFilter(logging.Filter):\n def filter(self, record):\n try:\n record.request_id = app.ctx.request_id.get(None) or \"n/a\"\n except AttributeError:\n record.request_id = \"n/a\"\n return True\n\n\nLOG_SETTINGS = {\n \"version\": 1,\n \"disable_existing_loggers\": False,\n \"handlers\": {\n \"console\": {\n \"class\": \"logging.StreamHandler\",\n \"level\": \"DEBUG\",\n \"formatter\": \"default\",\n \"filters\": [\"requestid\"],\n },\n },\n \"filters\": {\n \"requestid\": {\n \"()\": RequestIdFilter,\n },\n },\n \"formatters\": {\n \"default\": {\n \"format\": (\n \"%(asctime)s %(levelname)s %(name)s:%(lineno)d\"\n \" %(request_id)s | %(message)s\"\n ),\n },\n },\n \"loggers\": {\n \"\": {\"level\": \"DEBUG\", \"handlers\": [\"console\"], \"propagate\": True},\n },\n}\n\n\napp = Sanic(\"Example\", log_config=LOG_SETTINGS)\n\n\n@app.on_request\nasync def set_request_id(request):\n request.app.ctx.request_id.set(request.id)\n log.info(f\"Setting {request.id=}\")\n\n\n@app.on_response\nasync def set_request_header(request, response):\n response.headers[\"X-Request-ID\"] = request.id\n\n\n@app.route(\"/\")\nasync def test(request):\n log.debug(\"X-Request-ID: %s\", request.id)\n log.info(\"Hello from test!\")\n return response.json({\"test\": True})\n\n\n@app.before_server_start\ndef setup(app, loop):\n app.ctx.request_id = ContextVar(\"request_id\")\n\n\nif __name__ == \"__main__\":\n app.run(port=9999, debug=True)\n" }, { "path": "examples/logdna_example.py", "content": "import logging\nimport socket\n\nfrom os import getenv\nfrom platform import node\nfrom uuid import getnode as get_mac\n\nfrom logdna import LogDNAHandler\n\nfrom sanic import Sanic\nfrom sanic.request import Request\nfrom sanic.response import json\n\n\nlog = logging.getLogger(\"logdna\")\nlog.setLevel(logging.INFO)\n\n\ndef get_my_ip_address(remote_server=\"google.com\"):\n with socket.socket(socket.AF_INET, socket.SOCK_DGRAM) as s:\n s.connect((remote_server, 80))\n return s.getsockname()[0]\n\n\ndef get_mac_address():\n h = iter(hex(get_mac())[2:].zfill(12))\n return \":\".join(i + next(h) for i in h)\n\n\nlogdna_options = {\n \"app\": __name__,\n \"index_meta\": True,\n \"hostname\": node(),\n \"ip\": get_my_ip_address(),\n \"mac\": get_mac_address(),\n}\n\nlogdna_handler = LogDNAHandler(\n getenv(\"LOGDNA_API_KEY\"), options=logdna_options\n)\n\nlogdna = logging.getLogger(__name__)\nlogdna.setLevel(logging.INFO)\nlogdna.addHandler(logdna_handler)\n\napp = Sanic(\"Example\")\n\n\n@app.middleware\ndef log_request(request: Request):\n logdna.info(\"I was Here with a new Request to URL: {}\".format(request.url))\n\n\n@app.route(\"/\")\ndef default(request):\n return json({\"response\": \"I was here\"})\n\n\nif __name__ == \"__main__\":\n app.run(host=\"0.0.0.0\", port=getenv(\"PORT\", 8080))\n" }, { "path": "examples/modify_header_example.py", "content": "\"\"\"\nModify header or status in response\n\"\"\"\n\nfrom sanic import Sanic, response\n\n\napp = Sanic(\"Example\")\n\n\n@app.route(\"/\")\ndef handle_request(request):\n return response.json(\n {\"message\": \"Hello world!\"},\n headers={\"X-Served-By\": \"sanic\"},\n status=200,\n )\n\n\n@app.route(\"/unauthorized\")\ndef handle_unauthorized_request(request):\n return response.json(\n {\"message\": \"You are not authorized\"},\n headers={\"X-Served-By\": \"sanic\"},\n status=404,\n )\n\n\nif __name__ == \"__main__\":\n app.run(host=\"0.0.0.0\", port=8000, debug=True)\n" }, { "path": "examples/override_logging.py", "content": "import logging\n\nfrom sanic import Sanic, text\n\n\nlogging_format = \"[%(asctime)s] %(process)d-%(levelname)s \"\nlogging_format += \"%(module)s::%(funcName)s():l%(lineno)d: \"\nlogging_format += \"%(message)s\"\n\nlogging.basicConfig(format=logging_format, level=logging.DEBUG)\nlog = logging.getLogger()\n\n# Set logger to override default basicConfig\napp = Sanic(\"app\")\n\n\n@app.route(\"/\")\ndef test(request):\n log.info(\"received request; responding with 'hey'\")\n return text(\"hey\")\n\n\nif __name__ == \"__main__\":\n app.run(host=\"0.0.0.0\", port=8000)\n" }, { "path": "examples/pytest_xdist.py", "content": "\"\"\"pytest-xdist example for sanic server\n\nInstall testing tools:\n\n $ pip install pytest pytest-xdist\n\nRun with xdist params:\n\n $ pytest examples/pytest_xdist.py -n 8 # 8 workers\n\"\"\"\n\nimport re\n\nimport pytest\n\nfrom sanic_testing import SanicTestClient\nfrom sanic_testing.testing import PORT as PORT_BASE\n\nfrom sanic import Sanic\nfrom sanic.response import text\n\n\n@pytest.fixture(scope=\"session\")\ndef test_port(worker_id):\n m = re.search(r\"[0-9]+\", worker_id)\n if m:\n num_id = m.group(0)\n else:\n num_id = 0\n port = PORT_BASE + int(num_id)\n return port\n\n\n@pytest.fixture(scope=\"session\")\ndef app():\n app = Sanic(\"Example\")\n\n @app.route(\"/\")\n async def index(request):\n return text(\"OK\")\n\n return app\n\n\n@pytest.fixture(scope=\"session\")\ndef client(app, test_port):\n return SanicTestClient(app, test_port)\n\n\n@pytest.mark.parametrize(\"run_id\", range(100))\ndef test_index(client, run_id):\n request, response = client._sanic_endpoint_test(\"get\", \"/\")\n assert response.status == 200\n assert response.text == \"OK\"\n" }, { "path": "examples/raygun_example.py", "content": "from os import getenv\n\nfrom raygun4py.raygunprovider import RaygunSender\n\nfrom sanic import Sanic\nfrom sanic.exceptions import SanicException\nfrom sanic.handlers import ErrorHandler\n\n\nclass RaygunExceptionReporter(ErrorHandler):\n def __init__(self, raygun_api_key=None):\n super().__init__()\n if raygun_api_key is None:\n raygun_api_key = getenv(\"RAYGUN_API_KEY\")\n\n self.sender = RaygunSender(raygun_api_key)\n\n def default(self, request, exception):\n self.sender.send_exception(exception=exception)\n return super().default(request, exception)\n\n\nraygun_error_reporter = RaygunExceptionReporter()\napp = Sanic(\"Example\", error_handler=raygun_error_reporter)\n\n\n@app.route(\"/raise\")\nasync def test(request):\n raise SanicException(\"You Broke It!\")\n\n\nif __name__ == \"__main__\":\n app.run(host=\"0.0.0.0\", port=getenv(\"PORT\", 8080))\n" }, { "path": "examples/redirect_example.py", "content": "from sanic import Sanic, response\n\n\napp = Sanic(\"Example\")\n\n\n@app.route(\"/\")\ndef handle_request(request):\n return response.redirect(\"/redirect\")\n\n\n@app.route(\"/redirect\")\nasync def test(request):\n return response.json({\"Redirected\": True})\n\n\nif __name__ == \"__main__\":\n app.run(host=\"0.0.0.0\", port=8000)\n" }, { "path": "examples/request_stream/client.py", "content": "import requests\n\n\n# Warning: This is a heavy process.\n\ndata = \"\"\nfor i in range(1, 250000):\n data += str(i)\n\nr = requests.post(\"http://0.0.0.0:8000/stream\", data=data)\nprint(r.text)\n" }, { "path": "examples/request_stream/server.py", "content": "from sanic import Sanic\nfrom sanic.blueprints import Blueprint\nfrom sanic.response import stream, text\nfrom sanic.views import HTTPMethodView\nfrom sanic.views import stream as stream_decorator\n\n\nbp = Blueprint(\"bp_example\")\napp = Sanic(\"Example\")\n\n\nclass SimpleView(HTTPMethodView):\n @stream_decorator\n async def post(self, request):\n result = \"\"\n while True:\n body = await request.stream.get()\n if body is None:\n break\n result += body.decode(\"utf-8\")\n return text(result)\n\n\n@app.post(\"/stream\", stream=True)\nasync def handler(request):\n async def streaming(response):\n while True:\n body = await request.stream.get()\n if body is None:\n break\n body = body.decode(\"utf-8\").replace(\"1\", \"A\")\n await response.write(body)\n\n return stream(streaming)\n\n\n@bp.put(\"/bp_stream\", stream=True)\nasync def bp_handler(request):\n result = \"\"\n while True:\n body = await request.stream.get()\n if body is None:\n break\n result += body.decode(\"utf-8\").replace(\"1\", \"A\")\n return text(result)\n\n\nasync def post_handler(request):\n result = \"\"\n while True:\n body = await request.stream.get()\n if body is None:\n break\n result += body.decode(\"utf-8\")\n return text(result)\n\n\napp.blueprint(bp)\napp.add_route(SimpleView.as_view(), \"/method_view\")\n\n\nif __name__ == \"__main__\":\n app.run(host=\"0.0.0.0\", port=8000)\n" }, { "path": "examples/request_timeout.py", "content": "import asyncio\n\nfrom sanic import Sanic, response\nfrom sanic.config import Config\nfrom sanic.exceptions import RequestTimeout\n\n\nConfig.REQUEST_TIMEOUT = 1\napp = Sanic(\"Example\")\n\n\n@app.route(\"/\")\nasync def test(request):\n await asyncio.sleep(3)\n return response.text(\"Hello, world!\")\n\n\n@app.exception(RequestTimeout)\ndef timeout(request, exception):\n return response.text(\"RequestTimeout from error_handler.\", 408)\n\n\nif __name__ == \"__main__\":\n app.run(host=\"0.0.0.0\", port=8000)\n" }, { "path": "examples/rollbar_example.py", "content": "from os import getenv\n\nimport rollbar\n\nfrom sanic import Sanic\nfrom sanic.exceptions import SanicException\nfrom sanic.handlers import ErrorHandler\n\n\nrollbar.init(getenv(\"ROLLBAR_API_KEY\"))\n\n\nclass RollbarExceptionHandler(ErrorHandler):\n def default(self, request, exception):\n rollbar.report_message(str(exception))\n return super().default(request, exception)\n\n\napp = Sanic(\"Example\", error_handler=RollbarExceptionHandler())\n\n\n@app.route(\"/raise\")\ndef create_error(request):\n raise SanicException(\"I was here and I don't like where I am\")\n\n\nif __name__ == \"__main__\":\n app.run(host=\"0.0.0.0\", port=getenv(\"PORT\", 8080))\n" }, { "path": "examples/run_asgi.py", "content": "\"\"\"\n1. Create a simple Sanic app\n0. Run with an ASGI server:\n $ uvicorn run_asgi:app\n or\n $ hypercorn run_asgi:app\n\"\"\"\n\nfrom pathlib import Path\n\nfrom sanic import Sanic, response\n\n\napp = Sanic(\"Example\")\n\n\n@app.route(\"/text\")\ndef handler_text(request):\n return response.text(\"Hello\")\n\n\n@app.route(\"/json\")\ndef handler_json(request):\n return response.json({\"foo\": \"bar\"})\n\n\n@app.websocket(\"/ws\")\nasync def handler_ws(request, ws):\n name = \"\"\n while True:\n data = f\"Hello {name}\"\n await ws.send(data)\n name = await ws.recv()\n\n if not name:\n break\n\n\n@app.route(\"/file\")\nasync def handler_file(request):\n return await response.file(Path(\"../\") / \"setup.py\")\n\n\n@app.route(\"/file_stream\")\nasync def handler_file_stream(request):\n return await response.file_stream(\n Path(\"../\") / \"setup.py\", chunk_size=1024\n )\n\n\n@app.post(\"/stream\", stream=True)\nasync def handler_stream(request):\n while True:\n body = await request.stream.read()\n if body is None:\n break\n body = body.decode(\"utf-8\").replace(\"1\", \"A\")\n await response.write(body)\n return response.stream(body)\n\n\n@app.before_server_start\nasync def listener_before_server_start(*args, **kwargs):\n print(\"before_server_start\")\n\n\n@app.after_server_start\nasync def listener_after_server_start(*args, **kwargs):\n print(\"after_server_start\")\n\n\n@app.before_server_stop\nasync def listener_before_server_stop(*args, **kwargs):\n print(\"before_server_stop\")\n\n\n@app.after_server_stop\nasync def listener_after_server_stop(*args, **kwargs):\n print(\"after_server_stop\")\n\n\n@app.on_request\nasync def print_on_request(request):\n print(\"print_on_request\")\n\n\n@app.on_response\nasync def print_on_response(request, response):\n print(\"print_on_response\")\n" }, { "path": "examples/run_async.py", "content": "import asyncio\n\nimport uvloop\n\nfrom sanic import Sanic, response\n\n\napp = Sanic(\"Example\")\n\n\n@app.route(\"/\")\nasync def test(request):\n return response.json({\"answer\": \"42\"})\n\n\nasync def main():\n server = await app.create_server(\n port=8000, host=\"0.0.0.0\", return_asyncio_server=True\n )\n\n if server is None:\n return\n\n await server.startup()\n await server.serve_forever()\n\n\nif __name__ == \"__main__\":\n asyncio.set_event_loop(uvloop.new_event_loop())\n asyncio.run(main())\n" }, { "path": "examples/run_async_advanced.py", "content": "import asyncio\n\nfrom signal import SIGINT, signal\n\nimport uvloop\n\nfrom sanic import Sanic, response\nfrom sanic.server import AsyncioServer\n\n\napp = Sanic(\"Example\")\n\n\n@app.before_server_start\nasync def before_server_start(app, loop):\n print(\"Async Server starting\")\n\n\n@app.after_server_start\nasync def after_server_start(app, loop):\n print(\"Async Server started\")\n\n\n@app.before_server_stop\nasync def before_server_stop(app, loop):\n print(\"Async Server stopping\")\n\n\n@app.after_server_stop\nasync def after_server_stop(app, loop):\n print(\"Async Server stopped\")\n\n\n@app.route(\"/\")\nasync def test(request):\n return response.json({\"answer\": \"42\"})\n\n\nif __name__ == \"__main__\":\n asyncio.set_event_loop(uvloop.new_event_loop())\n serv_coro = app.create_server(\n host=\"0.0.0.0\", port=8000, return_asyncio_server=True\n )\n loop = asyncio.get_event_loop()\n serv_task = asyncio.ensure_future(serv_coro, loop=loop)\n signal(SIGINT, lambda s, f: loop.stop())\n server: AsyncioServer = loop.run_until_complete(serv_task)\n loop.run_until_complete(server.startup())\n\n # When using app.run(), this actually triggers before the serv_coro.\n # But, in this example, we are using the convenience method, even if it is\n # out of order.\n loop.run_until_complete(server.before_start())\n loop.run_until_complete(server.after_start())\n try:\n loop.run_forever()\n except KeyboardInterrupt:\n loop.stop()\n finally:\n loop.run_until_complete(server.before_stop())\n\n # Wait for server to close\n close_task = server.close()\n loop.run_until_complete(close_task)\n\n # Complete all tasks on the loop\n for connection in server.connections:\n connection.close_if_idle()\n loop.run_until_complete(server.after_stop())\n" }, { "path": "examples/sentry_example.py", "content": "from os import getenv\n\nfrom sentry_sdk import init as sentry_init\nfrom sentry_sdk.integrations.sanic import SanicIntegration\n\nfrom sanic import Sanic\nfrom sanic.response import json\n\n\nsentry_init(\n dsn=getenv(\"SENTRY_DSN\"),\n integrations=[SanicIntegration()],\n)\n\napp = Sanic(\"Example\")\n\n\n# noinspection PyUnusedLocal\n@app.route(\"/working\")\nasync def working_path(request):\n return json({\"response\": \"Working API Response\"})\n\n\n# noinspection PyUnusedLocal\n@app.route(\"/raise-error\")\nasync def raise_error(request):\n raise Exception(\"Testing Sentry Integration\")\n\n\nif __name__ == \"__main__\":\n app.run(host=\"0.0.0.0\", port=getenv(\"PORT\", 8080))\n" }, { "path": "examples/simple_async_view.py", "content": "from sanic import Sanic\nfrom sanic.response import text\nfrom sanic.views import HTTPMethodView\n\n\napp = Sanic(\"some_name\")\n\n\nclass SimpleView(HTTPMethodView):\n def get(self, request):\n return text(\"I am get method\")\n\n def post(self, request):\n return text(\"I am post method\")\n\n def put(self, request):\n return text(\"I am put method\")\n\n def patch(self, request):\n return text(\"I am patch method\")\n\n def delete(self, request):\n return text(\"I am delete method\")\n\n\nclass SimpleAsyncView(HTTPMethodView):\n async def get(self, request):\n return text(\"I am async get method\")\n\n async def post(self, request):\n return text(\"I am async post method\")\n\n async def put(self, request):\n return text(\"I am async put method\")\n\n\napp.add_route(SimpleView.as_view(), \"/\")\napp.add_route(SimpleAsyncView.as_view(), \"/async\")\n\nif __name__ == \"__main__\":\n app.run(host=\"0.0.0.0\", port=8000, debug=True)\n" }, { "path": "examples/static/robots.txt", "content": "User-agent: *\nDisallow: /\n" }, { "path": "examples/static_assets.py", "content": "from sanic import Sanic\n\n\napp = Sanic(\"Example\")\n\napp.static(\"/\", \"./static\")\n" }, { "path": "examples/teapot.py", "content": "from sanic import Sanic\nfrom sanic import response as res\n\n\napp = Sanic(\"Example\")\n\n\n@app.route(\"/\")\nasync def test(req):\n return res.text(\"I'm a teapot\", status=418)\n\n\nif __name__ == \"__main__\":\n app.run(host=\"0.0.0.0\", port=8000)\n" }, { "path": "examples/try_everything.py", "content": "import os\n\nfrom sanic import Sanic, response\nfrom sanic.exceptions import ServerError\nfrom sanic.log import logger as log\n\n\napp = Sanic(\"Example\")\n\n\n@app.route(\"/\")\nasync def test_async(request):\n return response.json({\"test\": True})\n\n\n@app.route(\"/sync\", methods=[\"GET\", \"POST\"])\ndef test_sync(request):\n return response.json({\"test\": True})\n\n\n@app.route(\"/dynamic//\")\ndef test_params(request, name, i):\n return response.text(\"yeehaww {} {}\".format(name, i))\n\n\n@app.route(\"/exception\")\ndef exception(request):\n raise ServerError(\"It's dead jim\")\n\n\n@app.route(\"/await\")\nasync def test_await(request):\n import asyncio\n\n await asyncio.sleep(5)\n return response.text(\"I'm feeling sleepy\")\n\n\n@app.route(\"/file\")\nasync def test_file(request):\n return await response.file(os.path.abspath(\"setup.py\"))\n\n\n@app.route(\"/file_stream\")\nasync def test_file_stream(request):\n return await response.file_stream(\n os.path.abspath(\"setup.py\"), chunk_size=1024\n )\n\n\n# ----------------------------------------------- #\n# Exceptions\n# ----------------------------------------------- #\n\n\n@app.exception(ServerError)\nasync def test(request, exception):\n return response.json(\n {\"exception\": str(exception), \"status\": exception.status_code},\n status=exception.status_code,\n )\n\n\n# ----------------------------------------------- #\n# Read from request\n# ----------------------------------------------- #\n\n\n@app.route(\"/json\")\ndef post_json(request):\n return response.json({\"received\": True, \"message\": request.json})\n\n\n@app.route(\"/form\")\ndef post_form_json(request):\n return response.json(\n {\n \"received\": True,\n \"form_data\": request.form,\n \"test\": request.form.get(\"test\"),\n }\n )\n\n\n@app.route(\"/query_string\")\ndef query_string(request):\n return response.json(\n {\n \"parsed\": True,\n \"args\": request.args,\n \"url\": request.url,\n \"query_string\": request.query_string,\n }\n )\n\n\n# ----------------------------------------------- #\n# Run Server\n# ----------------------------------------------- #\n\n\n@app.before_server_start\ndef before_start(app, loop):\n log.info(\"SERVER STARTING\")\n\n\n@app.after_server_start\ndef after_start(app, loop):\n log.info(\"OH OH OH OH OHHHHHHHH\")\n\n\n@app.before_server_stop\ndef before_stop(app, loop):\n log.info(\"SERVER STOPPING\")\n\n\n@app.after_server_stop\ndef after_stop(app, loop):\n log.info(\"TRIED EVERYTHING\")\n\n\nif __name__ == \"__main__\":\n app.run(host=\"0.0.0.0\", port=8000, debug=True)\n" }, { "path": "examples/unix_socket.py", "content": "from sanic import Sanic, response\n\n\napp = Sanic(\"Example\")\n\n\n@app.route(\"/test\")\nasync def test(request):\n return response.text(\"OK\")\n\n\nif __name__ == \"__main__\":\n app.run(unix=\"./uds_socket\")\n" }, { "path": "examples/url_for_example.py", "content": "from sanic import Sanic, response\n\n\napp = Sanic(\"Example\")\n\n\n@app.route(\"/\")\nasync def index(request):\n # generate a URL for the endpoint `post_handler`\n url = app.url_for(\"post_handler\", post_id=5)\n # the URL is `/posts/5`, redirect to it\n return response.redirect(url)\n\n\n@app.route(\"/posts/\")\nasync def post_handler(request, post_id):\n return response.text(\"Post - {}\".format(post_id))\n\n\nif __name__ == \"__main__\":\n app.run(host=\"0.0.0.0\", port=8000, debug=True)\n" }, { "path": "examples/versioned_blueprint_group.py", "content": "from sanic import Sanic\nfrom sanic.blueprints import Blueprint\nfrom sanic.response import json\n\n\napp = Sanic(name=\"blue-print-group-version-example\")\n\nbp1 = Blueprint(name=\"ultron\", url_prefix=\"/ultron\")\nbp2 = Blueprint(name=\"vision\", url_prefix=\"/vision\", strict_slashes=None)\n\nbpg = Blueprint.group(\n bp1, bp2, url_prefix=\"/sentient/robot\", version=1, strict_slashes=True\n)\n\n\n@bp1.get(\"/name\")\nasync def bp1_name(request):\n \"\"\"This will expose an Endpoint GET /v1/sentient/robot/ultron/name\"\"\"\n return json({\"name\": \"Ultron\"})\n\n\n@bp2.get(\"/name\")\nasync def bp2_name(request):\n \"\"\"This will expose an Endpoint GET /v1/sentient/robot/vision/name\"\"\"\n return json({\"name\": \"vision\"})\n\n\n@bp2.get(\"/name\", version=2)\nasync def bp2_revised_name(request):\n \"\"\"This will expose an Endpoint GET /v2/sentient/robot/vision/name\"\"\"\n return json({\"name\": \"new vision\"})\n\n\napp.blueprint(bpg)\n\nif __name__ == \"__main__\":\n app.run(host=\"0.0.0.0\", port=8000)\n" }, { "path": "examples/vhosts.py", "content": "from sanic import Sanic, response\nfrom sanic.blueprints import Blueprint\n\n\n# Usage\n# curl -H \"Host: example.com\" localhost:8000\n# curl -H \"Host: sub.example.com\" localhost:8000\n# curl -H \"Host: bp.example.com\" localhost:8000/question\n# curl -H \"Host: bp.example.com\" localhost:8000/answer\n\napp = Sanic(\"Example\")\nbp = Blueprint(\"bp\", host=\"bp.example.com\")\n\n\n@app.route(\n \"/\", host=[\"example.com\", \"somethingelse.com\", \"therestofyourdomains.com\"]\n)\nasync def hello_0(request):\n return response.text(\"Some defaults\")\n\n\n@app.route(\"/\", host=\"sub.example.com\")\nasync def hello_1(request):\n return response.text(\"42\")\n\n\n@bp.route(\"/question\")\nasync def hello_2(request):\n return response.text(\"What is the meaning of life?\")\n\n\n@bp.route(\"/answer\")\nasync def hello_3(request):\n return response.text(\"42\")\n\n\n@app.get(\"/name\")\ndef name(request):\n return response.text(request.app.url_for(\"name\", _external=True))\n\n\napp.blueprint(bp)\n\nif __name__ == \"__main__\":\n app.run(host=\"0.0.0.0\", port=8000)\n" }, { "path": "examples/websocket.html", "content": "\n\n \n WebSocket demo\n \n \n \n \n\n" }, { "path": "examples/websocket.py", "content": "from sanic import Sanic\nfrom sanic.response import redirect\n\n\napp = Sanic(\"Example\")\n\n\napp.static(\"index.html\", \"websocket.html\")\n\n\n@app.route(\"/\")\ndef index(request):\n return redirect(\"index.html\")\n\n\n@app.websocket(\"/feed\")\nasync def feed(request, ws):\n while True:\n data = \"hello!\"\n print(\"Sending: \" + data)\n await ws.send(data)\n data = await ws.recv()\n print(\"Received: \" + data)\n\n\nif __name__ == \"__main__\":\n app.run(host=\"0.0.0.0\", port=8000, debug=True)\n" }, { "path": "guide/Procfile", "content": "web: sanic --port=${PORT} --host=0.0.0.0 --workers=1 server:app" }, { "path": "guide/config/en/general.yaml", "content": "current_version: \"25.12\"\n" }, { "path": "guide/config/en/navbar.yaml", "content": "root:\n - label: Home\n path: index.html\n - label: Community\n items:\n - label: Forums\n href: https://community.sanicframework.org\n - label: Discord\n href: https://discord.gg/FARQzAEMAA\n - label: Twitter\n href: https://twitter.com/sanicframework\n - label: Help\n path: ./help.html\n - label: GitHub\n href: https://github.com/sanic-org/sanic\n" }, { "path": "guide/config/en/sidebar.yaml", "content": "root:\n - label: User Guide\n items:\n - label: General\n items:\n - label: Introduction\n path: guide/introduction.html\n - label: Getting Started\n path: guide/getting-started.html\n - label: Basics\n items:\n - label: Sanic Application\n path: guide/basics/app.html\n - label: Handlers\n path: guide/basics/handlers.html\n - label: Request\n path: guide/basics/request.html\n - label: Response\n path: guide/basics/response.html\n - label: Routing\n path: guide/basics/routing.html\n - label: Listeners\n path: guide/basics/listeners.html\n - label: Middleware\n path: guide/basics/middleware.html\n - label: Headers\n path: guide/basics/headers.html\n - label: Cookies\n path: guide/basics/cookies.html\n - label: Background Tasks\n path: guide/basics/tasks.html\n - label: Advanced\n items:\n - label: Class Based Views\n path: guide/advanced/class-based-views.html\n - label: Proxy Configuration\n path: guide/advanced/proxy-headers.html\n - label: Streaming\n path: guide/advanced/streaming.html\n - label: Websockets\n path: guide/advanced/websockets.html\n - label: Versioning\n path: guide/advanced/versioning.html\n - label: Signals\n path: guide/advanced/signals.html\n - label: Custom CLI Commands\n path: guide/advanced/commands.html\n - label: Best Practices\n items:\n - label: Blueprints\n path: guide/best-practices/blueprints.html\n - label: Exceptions\n path: guide/best-practices/exceptions.html\n - label: Decorators\n path: guide/best-practices/decorators.html\n - label: Logging\n path: guide/best-practices/logging.html\n - label: Testing\n path: guide/best-practices/testing.html\n - label: Running Sanic\n items:\n - label: Configuration\n path: guide/running/configuration.html\n - label: Development\n path: guide/running/development.html\n - label: Running Sanic\n path: guide/running/running.html\n - label: Worker Manager\n path: guide/running/manager.html\n - label: Dynamic Applications\n path: guide/running/app-loader.html\n - label: Inspector\n path: guide/running/inspector.html\n - label: Deployment\n items:\n - label: Caddy\n path: guide/deployment/caddy.html\n - label: Nginx\n path: guide/deployment/nginx.html\n - label: Docker\n path: guide/deployment/docker.html\n - label: How to ...\n items:\n - label: Table of Contents\n path: guide/how-to/table-of-contents.html\n - label: Application Mounting\n path: guide/how-to/mounting.html\n - label: Authentication\n path: guide/how-to/authentication.html\n - label: Autodiscovery\n path: guide/how-to/autodiscovery.html\n - label: CORS\n path: guide/how-to/cors.html\n - label: ORM\n path: guide/how-to/orm.html\n - label: Static Redirects\n path: guide/how-to/static-redirects.html\n - label: TLS/SSL/HTTPS\n path: guide/how-to/tls.html\n - label: Plugins\n items:\n - label: Sanic Extensions\n items:\n - label: Getting Started\n path: plugins/sanic-ext/getting-started.html\n - label: HTTP - Methods\n path: plugins/sanic-ext/http/methods.html\n - label: HTTP - CORS Protection\n path: plugins/sanic-ext/http/cors.html\n - label: OpenAPI - Basics\n path: plugins/sanic-ext/openapi/basics.html\n - label: OpenAPI - UI\n path: plugins/sanic-ext/openapi/ui.html\n - label: OpenAPI - Decorators\n path: plugins/sanic-ext/openapi/decorators.html\n # - label: OpenAPI - Advanced\n # path: plugins/sanic-ext/openapi/advanced.html\n - label: OpenAPI - Auto Documentation\n path: plugins/sanic-ext/openapi/autodoc.html\n - label: OpenAPI - Security\n path: plugins/sanic-ext/openapi/security.html\n - label: Convenience\n path: plugins/sanic-ext/convenience.html\n - label: Templating - Jinja\n path: plugins/sanic-ext/templating/jinja.html\n - label: Templating - html5tagger\n path: plugins/sanic-ext/templating/html5tagger.html\n - label: Dependency Injection\n path: plugins/sanic-ext/injection.html\n - label: Validation\n path: plugins/sanic-ext/validation.html\n - label: Health Monitor\n path: plugins/sanic-ext/health-monitor.html\n - label: Background Logger\n path: plugins/sanic-ext/logger.html\n - label: Configuration\n path: plugins/sanic-ext/configuration.html\n - label: Custom Extensions\n path: plugins/sanic-ext/custom.html\n - label: Sanic Testing\n items:\n - label: Getting Started\n path: plugins/sanic-testing/getting-started.html\n - label: Test Clients\n path: plugins/sanic-testing/clients.html\n - label: Release Notes\n items:\n - label: \"2025\"\n items:\n - label: Sanic 25.12\n path: release-notes/2025/v25.12.html\n - label: Sanic 25.3\n path: release-notes/2025/v25.3.html\n - label: \"2024\"\n items:\n - label: Sanic 24.12\n path: release-notes/2024/v24.12.html\n - label: Sanic 24.6\n path: release-notes/2024/v24.6.html\n - label: \"2023\"\n items:\n - label: Sanic 23.12\n path: release-notes/2023/v23.12.html\n - label: Sanic 23.9\n path: release-notes/2023/v23.9.html\n - label: Sanic 23.6\n path: release-notes/2023/v23.6.html\n - label: Sanic 23.3\n path: release-notes/2023/v23.3.html\n - label: \"2022\"\n items:\n - label: Sanic 22.12\n path: release-notes/2022/v22.12.html\n - label: Sanic 22.9\n path: release-notes/2022/v22.9.html\n - label: Sanic 22.6\n path: release-notes/2022/v22.6.html\n - label: Sanic 22.3\n path: release-notes/2022/v22.3.html\n - label: \"2021\"\n items:\n - label: Sanic 21.12\n path: release-notes/2021/v21.12.html\n - label: Sanic 21.9\n path: release-notes/2021/v21.9.html\n - label: Sanic 21.6\n path: release-notes/2021/v21.6.html\n - label: Sanic 21.3\n path: release-notes/2021/v21.3.html\n - label: Changelog\n path: release-notes/changelog.html\n - label: Organization\n items:\n - label: Contributing\n path: organization/contributing.html\n - label: Code of Conduct\n path: organization/code-of-conduct.html\n - label: S.C.O.P.E. (Governance)\n path: organization/scope.html\n - label: Policies\n path: organization/policies.html\n - label: API Reference\n items:\n - label: Application\n items:\n - label: sanic.app\n path: /api/sanic.app.html\n - label: sanic.config\n path: /api/sanic.config.html\n - label: sanic.application\n path: /api/sanic.application.html\n - label: Blueprint\n items:\n - label: sanic.blueprints\n path: /api/sanic.blueprints.html\n - label: sanic.blueprint_group\n path: /api/sanic.blueprint_group.html\n - label: Constant\n items:\n - label: sanic.constants\n path: /api/sanic.constants.html\n - label: Core\n items:\n - label: sanic.cookies\n path: /api/sanic.cookies.html\n - label: sanic.handlers\n path: /api/sanic.handlers.html\n - label: sanic.headers\n path: /api/sanic.headers.html\n - label: sanic.middleware\n path: /api/sanic.middleware.html\n - label: sanic.mixins\n path: /api/sanic.mixins.html\n - label: sanic.request\n path: /api/sanic.request.html\n - label: sanic.response\n path: /api/sanic.response.html\n - label: sanic.views\n path: /api/sanic.views.html\n - label: Display\n items:\n - label: sanic.pages\n path: /api/sanic.pages.html\n - label: Exception\n items:\n - label: sanic.errorpages\n path: /api/sanic.errorpages.html\n - label: sanic.exceptions\n path: /api/sanic.exceptions.html\n - label: Model\n items:\n - label: sanic.models\n path: /api/sanic.models.html\n - label: Routing\n items:\n - label: sanic.router\n path: /api/sanic.router.html\n - label: sanic.signals\n path: /api/sanic.signals.html\n - label: Server\n items:\n - label: sanic.http\n path: /api/sanic.http.html\n - label: sanic.server\n path: /api/sanic.server.html\n - label: sanic.worker\n path: /api/sanic.worker.html\n - label: Utility\n items:\n - label: sanic.compat\n path: /api/sanic.compat.html\n - label: sanic.helpers\n path: /api/sanic.helpers.html\n - label: sanic.logging\n path: /api/sanic.logging.html\n - label: sanic.utils\n path: /api/sanic.utils.html\n" }, { "path": "guide/content/en/built-with-sanic.md", "content": "---\ntitle: Full Speed Ahead - How We Built This Site with Sanic\nlayout: main\n---\n\n.. attrs::\n :class: title\n\n Full Speed Ahead:\n\n.. attrs::\n :class: subtitle\n\n How We Built This Site with Sanic\n\nWelcome to our little corner of the Internet where we proudly say, \"Yes, we built this with Sanic!\" This isn't just a website; it's our playground, our test lab, our battlefield, and, well, our home.\n\n![](/assets/images/built-with-sanic.png)\n\n### The Story: \"We Drink Our Own Champagne\"\n\nWe believe in Sanic so much that we decided to put it to the ultimate test—running our own website. It's like a chef eating at their own restaurant, only with less risk of food poisoning.\n\nWhy? Because building a website or web application is hard. There are countless moving parts, a plethora of challenges, and the ever-present need for speed and reliability. We want to show you just one of the many ways you *could* do it.\n\nIn this high-stakes digital kitchen, Sanic is our secret ingredient. By deploying our own website on Sanic, we're not just showcasing its capabilities; we're stress-testing them in the real world. This is our chance to walk the walk, proving that Sanic isn't just good on paper—it's a robust, high-performance framework that can handle everything from the smallest blog to the busiest e-commerce site. \n\nSo, here we are, sipping our own champagne, confident in the knowledge that if Sanic can run our site, it can power yours too. Cheers to coding at the speed of thought! 🥂\n\n### The Setup: Digital Ocean, Ahoy!\n\nWe launched our site on Digital Ocean's App Platform because we love high-performance cloud sailing. Think of it as having a Ferrari in the cloud—fast, sleek, but way easier to handle.\n\nWhy go for simplicity? With a lean team and no DevOps gurus, we needed a no-fuss, straightforward solution. Digital Ocean gives us that smooth sailing platform-as-a-service (PaaS) experience. It’s perfect for our needs: easy setup, automatic deployments, and the kind of reliability that lets you sleep soundly.\n\nOur choice reflects our ethos: focus on your strengths and let the platform do the heavy lifting. For us, it means creating amazing web experiences with Sanic, supported by a deployment solution that's simple yet powerful. ⛵\n\n### The Code: GitHub's Where It's At\n\nAll our code is out in the open, basking in the glory of public scrutiny on GitHub. Why hide the magic? It's right there, in full view, at [our GitHub repository](https://github.com/sanic-org/sanic/tree/main/guide). Go ahead, take a peek, fork it, play with it, break it (and then kindly fix it).\n\nOpen-source isn't just a buzzword for us; it's our ethos. It's about building something bigger than ourselves, together. Our code is a testament to collaborative innovation, a playground for development, and a real-life example of Sanic in action.\n\nEvery line of code, every commit, reflects our journey with Sanic, showcasing how we leverage its speed and scalability. Your contributions, whether fixing a bug, suggesting a feature, or enhancing documentation, are what propel this project forward.\n\nSo, dive in, contribute your genius, and let's keep shaping the future of web development with Sanic. Together, we're not just coding – we're creating a community-driven powerhouse. 🚀\n\n### The Invitation: Write, Code, Break, Fix!\n\n- **Documentarians**: Love making complex stuff sound easy? Our docs are your canvas. Paint away in words! 🎨\n\n- **Code Ninjas**: Find bugs? Squash 'em. Got ideas? Code 'em. Make pull requests rain! 🥷\n\n- **Bug Hunters**: If you find bugs, don't just stare. Let us know. We love a good bug hunt. 🐛\n \n### The Bottom Line\n\nWe built this site with Sanic to show off what it can do. It's fast, it's fun, and it's what we use. So, if things load swiftly, pat us on the back. If they don't, well, uh... we blame cosmic rays?\n\nJoin us in making Sanic not just good, but \"I-can't-believe-it's-not-butter\" good!\n\nCheers,\nThe Sanic Team (who occasionally wear capes)\n" }, { "path": "guide/content/en/emoji.py", "content": "EMOJI = {\n \"1st_place_medal\": \"🥇\",\n \"2nd_place_medal\": \"🥈\",\n \"3rd_place_medal\": \"🥉\",\n \"AB_button_(blood_type)\": \"🆎\",\n \"ATM_sign\": \"🏧\",\n \"A_button_(blood_type)\": \"🅰\",\n \"Afghanistan\": \"🇦🇫\",\n \"Albania\": \"🇦🇱\",\n \"Algeria\": \"🇩🇿\",\n \"American_Samoa\": \"🇦🇸\",\n \"Andorra\": \"🇦🇩\",\n \"Angola\": \"🇦🇴\",\n \"Anguilla\": \"🇦🇮\",\n \"Antarctica\": \"🇦🇶\",\n \"Antigua_&_Barbuda\": \"🇦🇬\",\n \"Aquarius\": \"♒\",\n \"Argentina\": \"🇦🇷\",\n \"Aries\": \"♈\",\n \"Armenia\": \"🇦🇲\",\n \"Aruba\": \"🇦🇼\",\n \"Ascension_Island\": \"🇦🇨\",\n \"Australia\": \"🇦🇺\",\n \"Austria\": \"🇦🇹\",\n \"Azerbaijan\": \"🇦🇿\",\n \"BACK_arrow\": \"🔙\",\n \"B_button_(blood_type)\": \"🅱\",\n \"Bahamas\": \"🇧🇸\",\n \"Bahrain\": \"🇧🇭\",\n \"Bangladesh\": \"🇧🇩\",\n \"Barbados\": \"🇧🇧\",\n \"Belarus\": \"🇧🇾\",\n \"Belgium\": \"🇧🇪\",\n \"Belize\": \"🇧🇿\",\n \"Benin\": \"🇧🇯\",\n \"Bermuda\": \"🇧🇲\",\n \"Bhutan\": \"🇧🇹\",\n \"Bolivia\": \"🇧🇴\",\n \"Bosnia_&_Herzegovina\": \"🇧🇦\",\n \"Botswana\": \"🇧🇼\",\n \"Bouvet_Island\": \"🇧🇻\",\n \"Brazil\": \"🇧🇷\",\n \"British_Indian_Ocean_Territory\": \"🇮🇴\",\n \"British_Virgin_Islands\": \"🇻🇬\",\n \"Brunei\": \"🇧🇳\",\n \"Bulgaria\": \"🇧🇬\",\n \"Burkina_Faso\": \"🇧🇫\",\n \"Burundi\": \"🇧🇮\",\n \"CL_button\": \"🆑\",\n \"COOL_button\": \"🆒\",\n \"Cambodia\": \"🇰🇭\",\n \"Cameroon\": \"🇨🇲\",\n \"Canada\": \"🇨🇦\",\n \"Canary_Islands\": \"🇮🇨\",\n \"Cancer\": \"♋\",\n \"Cape_Verde\": \"🇨🇻\",\n \"Capricorn\": \"♑\",\n \"Caribbean_Netherlands\": \"🇧🇶\",\n \"Cayman_Islands\": \"🇰🇾\",\n \"Central_African_Republic\": \"🇨🇫\",\n \"Ceuta_&_Melilla\": \"🇪🇦\",\n \"Chad\": \"🇹🇩\",\n \"Chile\": \"🇨🇱\",\n \"China\": \"🇨🇳\",\n \"Christmas_Island\": \"🇨🇽\",\n \"Christmas_tree\": \"🎄\",\n \"Clipperton_Island\": \"🇨🇵\",\n \"Cocos_(Keeling)_Islands\": \"🇨🇨\",\n \"Colombia\": \"🇨🇴\",\n \"Comoros\": \"🇰🇲\",\n \"Congo-Brazzaville\": \"🇨🇬\",\n \"Congo-Kinshasa\": \"🇨🇩\",\n \"Cook_Islands\": \"🇨🇰\",\n \"Costa_Rica\": \"🇨🇷\",\n \"Croatia\": \"🇭🇷\",\n \"Cuba\": \"🇨🇺\",\n \"Curaçao\": \"🇨🇼\",\n \"Cyprus\": \"🇨🇾\",\n \"Czechia\": \"🇨🇿\",\n \"Côte_d’Ivoire\": \"🇨🇮\",\n \"Denmark\": \"🇩🇰\",\n \"Diego_Garcia\": \"🇩🇬\",\n \"Djibouti\": \"🇩🇯\",\n \"Dominica\": \"🇩🇲\",\n \"Dominican_Republic\": \"🇩🇴\",\n \"END_arrow\": \"🔚\",\n \"Ecuador\": \"🇪🇨\",\n \"Egypt\": \"🇪🇬\",\n \"El_Salvador\": \"🇸🇻\",\n \"England\": \"🏴󠁧󠁢󠁥󠁮󠁧󠁿\",\n \"Equatorial_Guinea\": \"🇬🇶\",\n \"Eritrea\": \"🇪🇷\",\n \"Estonia\": \"🇪🇪\",\n \"Eswatini\": \"🇸🇿\",\n \"Ethiopia\": \"🇪🇹\",\n \"European_Union\": \"🇪🇺\",\n \"FREE_button\": \"🆓\",\n \"Falkland_Islands\": \"🇫🇰\",\n \"Faroe_Islands\": \"🇫🇴\",\n \"Fiji\": \"🇫🇯\",\n \"Finland\": \"🇫🇮\",\n \"France\": \"🇫🇷\",\n \"French_Guiana\": \"🇬🇫\",\n \"French_Polynesia\": \"🇵🇫\",\n \"French_Southern_Territories\": \"🇹🇫\",\n \"Gabon\": \"🇬🇦\",\n \"Gambia\": \"🇬🇲\",\n \"Gemini\": \"♊\",\n \"Georgia\": \"🇬🇪\",\n \"Germany\": \"🇩🇪\",\n \"Ghana\": \"🇬🇭\",\n \"Gibraltar\": \"🇬🇮\",\n \"Greece\": \"🇬🇷\",\n \"Greenland\": \"🇬🇱\",\n \"Grenada\": \"🇬🇩\",\n \"Guadeloupe\": \"🇬🇵\",\n \"Guam\": \"🇬🇺\",\n \"Guatemala\": \"🇬🇹\",\n \"Guernsey\": \"🇬🇬\",\n \"Guinea\": \"🇬🇳\",\n \"Guinea-Bissau\": \"🇬🇼\",\n \"Guyana\": \"🇬🇾\",\n \"Haiti\": \"🇭🇹\",\n \"Heard_&_McDonald_Islands\": \"🇭🇲\",\n \"Honduras\": \"🇭🇳\",\n \"Hong_Kong_SAR_China\": \"🇭🇰\",\n \"Hungary\": \"🇭🇺\",\n \"ID_button\": \"🆔\",\n \"Iceland\": \"🇮🇸\",\n \"India\": \"🇮🇳\",\n \"Indonesia\": \"🇮🇩\",\n \"Iran\": \"🇮🇷\",\n \"Iraq\": \"🇮🇶\",\n \"Ireland\": \"🇮🇪\",\n \"Isle_of_Man\": \"🇮🇲\",\n \"Israel\": \"🇮🇱\",\n \"Italy\": \"🇮🇹\",\n \"Jamaica\": \"🇯🇲\",\n \"Japan\": \"🇯🇵\",\n \"Japanese_acceptable_button\": \"🉑\",\n \"Japanese_application_button\": \"🈸\",\n \"Japanese_bargain_button\": \"🉐\",\n \"Japanese_castle\": \"🏯\",\n \"Japanese_congratulations_button\": \"㊗\",\n \"Japanese_discount_button\": \"🈹\",\n \"Japanese_dolls\": \"🎎\",\n \"Japanese_free_of_charge_button\": \"🈚\",\n \"Japanese_here_button\": \"🈁\",\n \"Japanese_monthly_amount_button\": \"🈷\",\n \"Japanese_no_vacancy_button\": \"🈵\",\n \"Japanese_not_free_of_charge_button\": \"🈶\",\n \"Japanese_open_for_business_button\": \"🈺\",\n \"Japanese_passing_grade_button\": \"🈴\",\n \"Japanese_post_office\": \"🏣\",\n \"Japanese_prohibited_button\": \"🈲\",\n \"Japanese_reserved_button\": \"🈯\",\n \"Japanese_secret_button\": \"㊙\",\n \"Japanese_service_charge_button\": \"🈂\",\n \"Japanese_symbol_for_beginner\": \"🔰\",\n \"Japanese_vacancy_button\": \"🈳\",\n \"Jersey\": \"🇯🇪\",\n \"Jordan\": \"🇯🇴\",\n \"Kazakhstan\": \"🇰🇿\",\n \"Kenya\": \"🇰🇪\",\n \"Kiribati\": \"🇰🇮\",\n \"Kosovo\": \"🇽🇰\",\n \"Kuwait\": \"🇰🇼\",\n \"Kyrgyzstan\": \"🇰🇬\",\n \"Laos\": \"🇱🇦\",\n \"Latvia\": \"🇱🇻\",\n \"Lebanon\": \"🇱🇧\",\n \"Leo\": \"♌\",\n \"Lesotho\": \"🇱🇸\",\n \"Liberia\": \"🇱🇷\",\n \"Libra\": \"♎\",\n \"Libya\": \"🇱🇾\",\n \"Liechtenstein\": \"🇱🇮\",\n \"Lithuania\": \"🇱🇹\",\n \"Luxembourg\": \"🇱🇺\",\n \"Macao_SAR_China\": \"🇲🇴\",\n \"Madagascar\": \"🇲🇬\",\n \"Malawi\": \"🇲🇼\",\n \"Malaysia\": \"🇲🇾\",\n \"Maldives\": \"🇲🇻\",\n \"Mali\": \"🇲🇱\",\n \"Malta\": \"🇲🇹\",\n \"Marshall_Islands\": \"🇲🇭\",\n \"Martinique\": \"🇲🇶\",\n \"Mauritania\": \"🇲🇷\",\n \"Mauritius\": \"🇲🇺\",\n \"Mayotte\": \"🇾🇹\",\n \"Mexico\": \"🇲🇽\",\n \"Micronesia\": \"🇫🇲\",\n \"Moldova\": \"🇲🇩\",\n \"Monaco\": \"🇲🇨\",\n \"Mongolia\": \"🇲🇳\",\n \"Montenegro\": \"🇲🇪\",\n \"Montserrat\": \"🇲🇸\",\n \"Morocco\": \"🇲🇦\",\n \"Mozambique\": \"🇲🇿\",\n \"Mrs._Claus\": \"🤶\",\n \"Mrs._Claus_dark_skin_tone\": \"🤶🏿\",\n \"Mrs._Claus_light_skin_tone\": \"🤶🏻\",\n \"Mrs._Claus_medium-dark_skin_tone\": \"🤶🏾\",\n \"Mrs._Claus_medium-light_skin_tone\": \"🤶🏼\",\n \"Mrs._Claus_medium_skin_tone\": \"🤶🏽\",\n \"Myanmar_(Burma)\": \"🇲🇲\",\n \"NEW_button\": \"🆕\",\n \"NG_button\": \"🆖\",\n \"Namibia\": \"🇳🇦\",\n \"Nauru\": \"🇳🇷\",\n \"Nepal\": \"🇳🇵\",\n \"Netherlands\": \"🇳🇱\",\n \"New_Caledonia\": \"🇳🇨\",\n \"New_Zealand\": \"🇳🇿\",\n \"Nicaragua\": \"🇳🇮\",\n \"Niger\": \"🇳🇪\",\n \"Nigeria\": \"🇳🇬\",\n \"Niue\": \"🇳🇺\",\n \"Norfolk_Island\": \"🇳🇫\",\n \"North_Korea\": \"🇰🇵\",\n \"North_Macedonia\": \"🇲🇰\",\n \"Northern_Mariana_Islands\": \"🇲🇵\",\n \"Norway\": \"🇳🇴\",\n \"OK_button\": \"🆗\",\n \"OK_hand\": \"👌\",\n \"OK_hand_dark_skin_tone\": \"👌🏿\",\n \"OK_hand_light_skin_tone\": \"👌🏻\",\n \"OK_hand_medium-dark_skin_tone\": \"👌🏾\",\n \"OK_hand_medium-light_skin_tone\": \"👌🏼\",\n \"OK_hand_medium_skin_tone\": \"👌🏽\",\n \"ON!_arrow\": \"🔛\",\n \"O_button_(blood_type)\": \"🅾\",\n \"Oman\": \"🇴🇲\",\n \"Ophiuchus\": \"⛎\",\n \"P_button\": \"🅿\",\n \"Pakistan\": \"🇵🇰\",\n \"Palau\": \"🇵🇼\",\n \"Palestinian_Territories\": \"🇵🇸\",\n \"Panama\": \"🇵🇦\",\n \"Papua_New_Guinea\": \"🇵🇬\",\n \"Paraguay\": \"🇵🇾\",\n \"Peru\": \"🇵🇪\",\n \"Philippines\": \"🇵🇭\",\n \"Pisces\": \"♓\",\n \"Pitcairn_Islands\": \"🇵🇳\",\n \"Poland\": \"🇵🇱\",\n \"Portugal\": \"🇵🇹\",\n \"Puerto_Rico\": \"🇵🇷\",\n \"Qatar\": \"🇶🇦\",\n \"Romania\": \"🇷🇴\",\n \"Russia\": \"🇷🇺\",\n \"Rwanda\": \"🇷🇼\",\n \"Réunion\": \"🇷🇪\",\n \"SOON_arrow\": \"🔜\",\n \"SOS_button\": \"🆘\",\n \"Sagittarius\": \"♐\",\n \"Samoa\": \"🇼🇸\",\n \"San_Marino\": \"🇸🇲\",\n \"Santa_Claus\": \"🎅\",\n \"Santa_Claus_dark_skin_tone\": \"🎅🏿\",\n \"Santa_Claus_light_skin_tone\": \"🎅🏻\",\n \"Santa_Claus_medium-dark_skin_tone\": \"🎅🏾\",\n \"Santa_Claus_medium-light_skin_tone\": \"🎅🏼\",\n \"Santa_Claus_medium_skin_tone\": \"🎅🏽\",\n \"Saudi_Arabia\": \"🇸🇦\",\n \"Scorpio\": \"♏\",\n \"Scotland\": \"🏴󠁧󠁢󠁳󠁣󠁴󠁿\",\n \"Senegal\": \"🇸🇳\",\n \"Serbia\": \"🇷🇸\",\n \"Seychelles\": \"🇸🇨\",\n \"Sierra_Leone\": \"🇸🇱\",\n \"Singapore\": \"🇸🇬\",\n \"Sint_Maarten\": \"🇸🇽\",\n \"Slovakia\": \"🇸🇰\",\n \"Slovenia\": \"🇸🇮\",\n \"Solomon_Islands\": \"🇸🇧\",\n \"Somalia\": \"🇸🇴\",\n \"South_Africa\": \"🇿🇦\",\n \"South_Georgia_&_South_Sandwich_Islands\": \"🇬🇸\",\n \"South_Korea\": \"🇰🇷\",\n \"South_Sudan\": \"🇸🇸\",\n \"Spain\": \"🇪🇸\",\n \"Sri_Lanka\": \"🇱🇰\",\n \"St._Barthélemy\": \"🇧🇱\",\n \"St._Helena\": \"🇸🇭\",\n \"St._Kitts_&_Nevis\": \"🇰🇳\",\n \"St._Lucia\": \"🇱🇨\",\n \"St._Martin\": \"🇲🇫\",\n \"St._Pierre_&_Miquelon\": \"🇵🇲\",\n \"St._Vincent_&_Grenadines\": \"🇻🇨\",\n \"Statue_of_Liberty\": \"🗽\",\n \"Sudan\": \"🇸🇩\",\n \"Suriname\": \"🇸🇷\",\n \"Svalbard_&_Jan_Mayen\": \"🇸🇯\",\n \"Sweden\": \"🇸🇪\",\n \"Switzerland\": \"🇨🇭\",\n \"Syria\": \"🇸🇾\",\n \"São_Tomé_&_Príncipe\": \"🇸🇹\",\n \"T-Rex\": \"🦖\",\n \"TOP_arrow\": \"🔝\",\n \"Taiwan\": \"🇹🇼\",\n \"Tajikistan\": \"🇹🇯\",\n \"Tanzania\": \"🇹🇿\",\n \"Taurus\": \"♉\",\n \"Thailand\": \"🇹🇭\",\n \"Timor-Leste\": \"🇹🇱\",\n \"Togo\": \"🇹🇬\",\n \"Tokelau\": \"🇹🇰\",\n \"Tokyo_tower\": \"🗼\",\n \"Tonga\": \"🇹🇴\",\n \"Trinidad_&_Tobago\": \"🇹🇹\",\n \"Tristan_da_Cunha\": \"🇹🇦\",\n \"Tunisia\": \"🇹🇳\",\n \"Turkey\": \"🇹🇷\",\n \"Turkmenistan\": \"🇹🇲\",\n \"Turks_&_Caicos_Islands\": \"🇹🇨\",\n \"Tuvalu\": \"🇹🇻\",\n \"U.S._Outlying_Islands\": \"🇺🇲\",\n \"U.S._Virgin_Islands\": \"🇻🇮\",\n \"UP!_button\": \"🆙\",\n \"Uganda\": \"🇺🇬\",\n \"Ukraine\": \"🇺🇦\",\n \"United_Arab_Emirates\": \"🇦🇪\",\n \"United_Kingdom\": \"🇬🇧\",\n \"United_Nations\": \"🇺🇳\",\n \"United_States\": \"🇺🇸\",\n \"Uruguay\": \"🇺🇾\",\n \"Uzbekistan\": \"🇺🇿\",\n \"VS_button\": \"🆚\",\n \"Vanuatu\": \"🇻🇺\",\n \"Vatican_City\": \"🇻🇦\",\n \"Venezuela\": \"🇻🇪\",\n \"Vietnam\": \"🇻🇳\",\n \"Virgo\": \"♍\",\n \"Wales\": \"🏴󠁧󠁢󠁷󠁬󠁳󠁿\",\n \"Wallis_&_Futuna\": \"🇼🇫\",\n \"Western_Sahara\": \"🇪🇭\",\n \"Yemen\": \"🇾🇪\",\n \"ZZZ\": \"💤\",\n \"Zambia\": \"🇿🇲\",\n \"Zimbabwe\": \"🇿🇼\",\n \"abacus\": \"🧮\",\n \"accordion\": \"🪗\",\n \"adhesive_bandage\": \"🩹\",\n \"admission_tickets\": \"🎟\",\n \"aerial_tramway\": \"🚡\",\n \"airplane\": \"✈\",\n \"airplane_arrival\": \"🛬\",\n \"airplane_departure\": \"🛫\",\n \"alarm_clock\": \"⏰\",\n \"alembic\": \"⚗\",\n \"alien\": \"👽\",\n \"alien_monster\": \"👾\",\n \"ambulance\": \"🚑\",\n \"american_football\": \"🏈\",\n \"amphora\": \"🏺\",\n \"anatomical_heart\": \"🫀\",\n \"anchor\": \"⚓\",\n \"anger_symbol\": \"💢\",\n \"angry_face\": \"😠\",\n \"angry_face_with_horns\": \"👿\",\n \"anguished_face\": \"😧\",\n \"ant\": \"🐜\",\n \"antenna_bars\": \"📶\",\n \"anxious_face_with_sweat\": \"😰\",\n \"articulated_lorry\": \"🚛\",\n \"artist\": \"🧑‍🎨\",\n \"artist_dark_skin_tone\": \"🧑🏿‍🎨\",\n \"artist_light_skin_tone\": \"🧑🏻‍🎨\",\n \"artist_medium-dark_skin_tone\": \"🧑🏾‍🎨\",\n \"artist_medium-light_skin_tone\": \"🧑🏼‍🎨\",\n \"artist_medium_skin_tone\": \"🧑🏽‍🎨\",\n \"artist_palette\": \"🎨\",\n \"astonished_face\": \"😲\",\n \"astronaut\": \"🧑‍🚀\",\n \"astronaut_dark_skin_tone\": \"🧑🏿‍🚀\",\n \"astronaut_light_skin_tone\": \"🧑🏻‍🚀\",\n \"astronaut_medium-dark_skin_tone\": \"🧑🏾‍🚀\",\n \"astronaut_medium-light_skin_tone\": \"🧑🏼‍🚀\",\n \"astronaut_medium_skin_tone\": \"🧑🏽‍🚀\",\n \"atom_symbol\": \"⚛\",\n \"auto_rickshaw\": \"🛺\",\n \"automobile\": \"🚗\",\n \"avocado\": \"🥑\",\n \"axe\": \"🪓\",\n \"baby\": \"👶\",\n \"baby_angel\": \"👼\",\n \"baby_angel_dark_skin_tone\": \"👼🏿\",\n \"baby_angel_light_skin_tone\": \"👼🏻\",\n \"baby_angel_medium-dark_skin_tone\": \"👼🏾\",\n \"baby_angel_medium-light_skin_tone\": \"👼🏼\",\n \"baby_angel_medium_skin_tone\": \"👼🏽\",\n \"baby_bottle\": \"🍼\",\n \"baby_chick\": \"🐤\",\n \"baby_dark_skin_tone\": \"👶🏿\",\n \"baby_light_skin_tone\": \"👶🏻\",\n \"baby_medium-dark_skin_tone\": \"👶🏾\",\n \"baby_medium-light_skin_tone\": \"👶🏼\",\n \"baby_medium_skin_tone\": \"👶🏽\",\n \"baby_symbol\": \"🚼\",\n \"backhand_index_pointing_down\": \"👇\",\n \"backhand_index_pointing_down_dark_skin_tone\": \"👇🏿\",\n \"backhand_index_pointing_down_light_skin_tone\": \"👇🏻\",\n \"backhand_index_pointing_down_medium-dark_skin_tone\": \"👇🏾\",\n \"backhand_index_pointing_down_medium-light_skin_tone\": \"👇🏼\",\n \"backhand_index_pointing_down_medium_skin_tone\": \"👇🏽\",\n \"backhand_index_pointing_left\": \"👈\",\n \"backhand_index_pointing_left_dark_skin_tone\": \"👈🏿\",\n \"backhand_index_pointing_left_light_skin_tone\": \"👈🏻\",\n \"backhand_index_pointing_left_medium-dark_skin_tone\": \"👈🏾\",\n \"backhand_index_pointing_left_medium-light_skin_tone\": \"👈🏼\",\n \"backhand_index_pointing_left_medium_skin_tone\": \"👈🏽\",\n \"backhand_index_pointing_right\": \"👉\",\n \"backhand_index_pointing_right_dark_skin_tone\": \"👉🏿\",\n \"backhand_index_pointing_right_light_skin_tone\": \"👉🏻\",\n \"backhand_index_pointing_right_medium-dark_skin_tone\": \"👉🏾\",\n \"backhand_index_pointing_right_medium-light_skin_tone\": \"👉🏼\",\n \"backhand_index_pointing_right_medium_skin_tone\": \"👉🏽\",\n \"backhand_index_pointing_up\": \"👆\",\n \"backhand_index_pointing_up_dark_skin_tone\": \"👆🏿\",\n \"backhand_index_pointing_up_light_skin_tone\": \"👆🏻\",\n \"backhand_index_pointing_up_medium-dark_skin_tone\": \"👆🏾\",\n \"backhand_index_pointing_up_medium-light_skin_tone\": \"👆🏼\",\n \"backhand_index_pointing_up_medium_skin_tone\": \"👆🏽\",\n \"backpack\": \"🎒\",\n \"bacon\": \"🥓\",\n \"badger\": \"🦡\",\n \"badminton\": \"🏸\",\n \"bagel\": \"🥯\",\n \"baggage_claim\": \"🛄\",\n \"baguette_bread\": \"🥖\",\n \"balance_scale\": \"⚖\",\n \"bald\": \"🦲\",\n \"ballet_shoes\": \"🩰\",\n \"balloon\": \"🎈\",\n \"ballot_box_with_ballot\": \"🗳\",\n \"banana\": \"🍌\",\n \"banjo\": \"🪕\",\n \"bank\": \"🏦\",\n \"bar_chart\": \"📊\",\n \"barber_pole\": \"💈\",\n \"baseball\": \"⚾\",\n \"basket\": \"🧺\",\n \"basketball\": \"🏀\",\n \"bat\": \"🦇\",\n \"bathtub\": \"🛁\",\n \"battery\": \"🔋\",\n \"beach_with_umbrella\": \"🏖\",\n \"beaming_face_with_smiling_eyes\": \"😁\",\n \"beans\": \"🫘\",\n \"bear\": \"🐻\",\n \"beating_heart\": \"💓\",\n \"beaver\": \"🦫\",\n \"bed\": \"🛏\",\n \"beer_mug\": \"🍺\",\n \"beetle\": \"🪲\",\n \"bell\": \"🔔\",\n \"bell_pepper\": \"🫑\",\n \"bell_with_slash\": \"🔕\",\n \"bellhop_bell\": \"🛎\",\n \"bento_box\": \"🍱\",\n \"beverage_box\": \"🧃\",\n \"bicycle\": \"🚲\",\n \"bikini\": \"👙\",\n \"billed_cap\": \"🧢\",\n \"biohazard\": \"☣\",\n \"bird\": \"🐦\",\n \"birthday_cake\": \"🎂\",\n \"bison\": \"🦬\",\n \"biting_lip\": \"🫦\",\n \"black_bird\": \"🐦‍⬛\",\n \"black_cat\": \"🐈‍⬛\",\n \"black_circle\": \"⚫\",\n \"black_flag\": \"🏴\",\n \"black_heart\": \"🖤\",\n \"black_large_square\": \"⬛\",\n \"black_medium-small_square\": \"◾\",\n \"black_medium_square\": \"◼\",\n \"black_nib\": \"✒\",\n \"black_small_square\": \"▪\",\n \"black_square_button\": \"🔲\",\n \"blossom\": \"🌼\",\n \"blowfish\": \"🐡\",\n \"blue_book\": \"📘\",\n \"blue_circle\": \"🔵\",\n \"blue_heart\": \"💙\",\n \"blue_square\": \"🟦\",\n \"blueberries\": \"🫐\",\n \"boar\": \"🐗\",\n \"bomb\": \"💣\",\n \"bone\": \"🦴\",\n \"bookmark\": \"🔖\",\n \"bookmark_tabs\": \"📑\",\n \"books\": \"📚\",\n \"boomerang\": \"🪃\",\n \"bottle_with_popping_cork\": \"🍾\",\n \"bouquet\": \"💐\",\n \"bow_and_arrow\": \"🏹\",\n \"bowl_with_spoon\": \"🥣\",\n \"bowling\": \"🎳\",\n \"boxing_glove\": \"🥊\",\n \"boy\": \"👦\",\n \"boy_dark_skin_tone\": \"👦🏿\",\n \"boy_light_skin_tone\": \"👦🏻\",\n \"boy_medium-dark_skin_tone\": \"👦🏾\",\n \"boy_medium-light_skin_tone\": \"👦🏼\",\n \"boy_medium_skin_tone\": \"👦🏽\",\n \"brain\": \"🧠\",\n \"bread\": \"🍞\",\n \"breast-feeding\": \"🤱\",\n \"breast-feeding_dark_skin_tone\": \"🤱🏿\",\n \"breast-feeding_light_skin_tone\": \"🤱🏻\",\n \"breast-feeding_medium-dark_skin_tone\": \"🤱🏾\",\n \"breast-feeding_medium-light_skin_tone\": \"🤱🏼\",\n \"breast-feeding_medium_skin_tone\": \"🤱🏽\",\n \"brick\": \"🧱\",\n \"bridge_at_night\": \"🌉\",\n \"briefcase\": \"💼\",\n \"briefs\": \"🩲\",\n \"bright_button\": \"🔆\",\n \"broccoli\": \"🥦\",\n \"broken_heart\": \"💔\",\n \"broom\": \"🧹\",\n \"brown_circle\": \"🟤\",\n \"brown_heart\": \"🤎\",\n \"brown_square\": \"🟫\",\n \"bubble_tea\": \"🧋\",\n \"bubbles\": \"🫧\",\n \"bucket\": \"🪣\",\n \"bug\": \"🐛\",\n \"building_construction\": \"🏗\",\n \"bullet_train\": \"🚅\",\n \"bullseye\": \"🎯\",\n \"burrito\": \"🌯\",\n \"bus\": \"🚌\",\n \"bus_stop\": \"🚏\",\n \"bust_in_silhouette\": \"👤\",\n \"busts_in_silhouette\": \"👥\",\n \"butter\": \"🧈\",\n \"butterfly\": \"🦋\",\n \"cactus\": \"🌵\",\n \"calendar\": \"📅\",\n \"call_me_hand\": \"🤙\",\n \"call_me_hand_dark_skin_tone\": \"🤙🏿\",\n \"call_me_hand_light_skin_tone\": \"🤙🏻\",\n \"call_me_hand_medium-dark_skin_tone\": \"🤙🏾\",\n \"call_me_hand_medium-light_skin_tone\": \"🤙🏼\",\n \"call_me_hand_medium_skin_tone\": \"🤙🏽\",\n \"camel\": \"🐪\",\n \"camera\": \"📷\",\n \"camera_with_flash\": \"📸\",\n \"camping\": \"🏕\",\n \"candle\": \"🕯\",\n \"candy\": \"🍬\",\n \"canned_food\": \"🥫\",\n \"canoe\": \"🛶\",\n \"card_file_box\": \"🗃\",\n \"card_index\": \"📇\",\n \"card_index_dividers\": \"🗂\",\n \"carousel_horse\": \"🎠\",\n \"carp_streamer\": \"🎏\",\n \"carpentry_saw\": \"🪚\",\n \"carrot\": \"🥕\",\n \"castle\": \"🏰\",\n \"cat\": \"🐈\",\n \"cat_face\": \"🐱\",\n \"cat_with_tears_of_joy\": \"😹\",\n \"cat_with_wry_smile\": \"😼\",\n \"chains\": \"⛓\",\n \"chair\": \"🪑\",\n \"chart_decreasing\": \"📉\",\n \"chart_increasing\": \"📈\",\n \"chart_increasing_with_yen\": \"💹\",\n \"check_box_with_check\": \"☑\",\n \"check_mark\": \"✔\",\n \"check_mark_button\": \"✅\",\n \"cheese_wedge\": \"🧀\",\n \"chequered_flag\": \"🏁\",\n \"cherries\": \"🍒\",\n \"cherry_blossom\": \"🌸\",\n \"chess_pawn\": \"♟\",\n \"chestnut\": \"🌰\",\n \"chicken\": \"🐔\",\n \"child\": \"🧒\",\n \"child_dark_skin_tone\": \"🧒🏿\",\n \"child_light_skin_tone\": \"🧒🏻\",\n \"child_medium-dark_skin_tone\": \"🧒🏾\",\n \"child_medium-light_skin_tone\": \"🧒🏼\",\n \"child_medium_skin_tone\": \"🧒🏽\",\n \"children_crossing\": \"🚸\",\n \"chipmunk\": \"🐿\",\n \"chocolate_bar\": \"🍫\",\n \"chopsticks\": \"🥢\",\n \"church\": \"⛪\",\n \"cigarette\": \"🚬\",\n \"cinema\": \"🎦\",\n \"circled_M\": \"Ⓜ\",\n \"circus_tent\": \"🎪\",\n \"cityscape\": \"🏙\",\n \"cityscape_at_dusk\": \"🌆\",\n \"clamp\": \"🗜\",\n \"clapper_board\": \"🎬\",\n \"clapping_hands\": \"👏\",\n \"clapping_hands_dark_skin_tone\": \"👏🏿\",\n \"clapping_hands_light_skin_tone\": \"👏🏻\",\n \"clapping_hands_medium-dark_skin_tone\": \"👏🏾\",\n \"clapping_hands_medium-light_skin_tone\": \"👏🏼\",\n \"clapping_hands_medium_skin_tone\": \"👏🏽\",\n \"classical_building\": \"🏛\",\n \"clinking_beer_mugs\": \"🍻\",\n \"clinking_glasses\": \"🥂\",\n \"clipboard\": \"📋\",\n \"clockwise_vertical_arrows\": \"🔃\",\n \"closed_book\": \"📕\",\n \"closed_mailbox_with_lowered_flag\": \"📪\",\n \"closed_mailbox_with_raised_flag\": \"📫\",\n \"closed_umbrella\": \"🌂\",\n \"cloud\": \"☁\",\n \"cloud_with_lightning\": \"🌩\",\n \"cloud_with_lightning_and_rain\": \"⛈\",\n \"cloud_with_rain\": \"🌧\",\n \"cloud_with_snow\": \"🌨\",\n \"clown_face\": \"🤡\",\n \"club_suit\": \"♣\",\n \"clutch_bag\": \"👝\",\n \"coat\": \"🧥\",\n \"cockroach\": \"🪳\",\n \"cocktail_glass\": \"🍸\",\n \"coconut\": \"🥥\",\n \"coffin\": \"⚰\",\n \"coin\": \"🪙\",\n \"cold_face\": \"🥶\",\n \"collision\": \"💥\",\n \"comet\": \"☄\",\n \"compass\": \"🧭\",\n \"computer_disk\": \"💽\",\n \"computer_mouse\": \"🖱\",\n \"confetti_ball\": \"🎊\",\n \"confounded_face\": \"😖\",\n \"confused_face\": \"😕\",\n \"construction\": \"🚧\",\n \"construction_worker\": \"👷\",\n \"construction_worker_dark_skin_tone\": \"👷🏿\",\n \"construction_worker_light_skin_tone\": \"👷🏻\",\n \"construction_worker_medium-dark_skin_tone\": \"👷🏾\",\n \"construction_worker_medium-light_skin_tone\": \"👷🏼\",\n \"construction_worker_medium_skin_tone\": \"👷🏽\",\n \"control_knobs\": \"🎛\",\n \"convenience_store\": \"🏪\",\n \"cook\": \"🧑‍🍳\",\n \"cook_dark_skin_tone\": \"🧑🏿‍🍳\",\n \"cook_light_skin_tone\": \"🧑🏻‍🍳\",\n \"cook_medium-dark_skin_tone\": \"🧑🏾‍🍳\",\n \"cook_medium-light_skin_tone\": \"🧑🏼‍🍳\",\n \"cook_medium_skin_tone\": \"🧑🏽‍🍳\",\n \"cooked_rice\": \"🍚\",\n \"cookie\": \"🍪\",\n \"cooking\": \"🍳\",\n \"copyright\": \"©\",\n \"coral\": \"🪸\",\n \"couch_and_lamp\": \"🛋\",\n \"counterclockwise_arrows_button\": \"🔄\",\n \"couple_with_heart\": \"💑\",\n \"couple_with_heart_dark_skin_tone\": \"💑🏿\",\n \"couple_with_heart_light_skin_tone\": \"💑🏻\",\n \"couple_with_heart_man_man\": \"👨‍❤‍👨\",\n \"couple_with_heart_man_man_dark_skin_tone\": \"👨🏿‍❤‍👨🏿\",\n \"couple_with_heart_man_man_dark_skin_tone_light_skin_tone\": \"👨🏿‍❤‍👨🏻\",\n (\n \"couple_with_heart_man_man_dark_skin_tone_medium-dark_skin_tone\"\n ): \"👨🏿‍❤‍👨🏾\",\n (\n \"couple_with_heart_man_man_dark_skin_tone_medium-light_skin_tone\"\n ): \"👨🏿‍❤‍👨🏼\",\n \"couple_with_heart_man_man_dark_skin_tone_medium_skin_tone\": \"👨🏿‍❤‍👨🏽\",\n \"couple_with_heart_man_man_light_skin_tone\": \"👨🏻‍❤‍👨🏻\",\n \"couple_with_heart_man_man_light_skin_tone_dark_skin_tone\": \"👨🏻‍❤‍👨🏿\",\n (\n \"couple_with_heart_man_man_light_skin_tone_medium-dark_skin_tone\"\n ): \"👨🏻‍❤‍👨🏾\",\n (\n \"couple_with_heart_man_man_light_skin_tone_medium-light_skin_tone\"\n ): \"👨🏻‍❤‍👨🏼\",\n \"couple_with_heart_man_man_light_skin_tone_medium_skin_tone\": \"👨🏻‍❤‍👨🏽\",\n \"couple_with_heart_man_man_medium-dark_skin_tone\": \"👨🏾‍❤‍👨🏾\",\n (\n \"couple_with_heart_man_man_medium-dark_skin_tone_dark_skin_tone\"\n ): \"👨🏾‍❤‍👨🏿\",\n (\n \"couple_with_heart_man_man_medium-dark_skin_tone_light_skin_tone\"\n ): \"👨🏾‍❤‍👨🏻\",\n (\n \"couple_with_heart_man_man_medium\"\n \"-dark_skin_tone_medium-light_skin_tone\"\n ): \"👨🏾‍❤‍👨🏼\",\n (\n \"couple_with_heart_man_man_medium-dark_skin_tone_medium_skin_tone\"\n ): \"👨🏾‍❤‍👨🏽\",\n \"couple_with_heart_man_man_medium-light_skin_tone\": \"👨🏼‍❤‍👨🏼\",\n (\n \"couple_with_heart_man_man_medium-light_skin_tone_dark_skin_tone\"\n ): \"👨🏼‍❤‍👨🏿\",\n (\n \"couple_with_heart_man_man_medium-light_skin_tone_light_skin_tone\"\n ): \"👨🏼‍❤‍👨🏻\",\n (\n \"couple_with_heart_man_man_medium\"\n \"-light_skin_tone_medium-dark_skin_tone\"\n ): \"👨🏼‍❤‍👨🏾\",\n (\n \"couple_with_heart_man_man_medium-light_skin_tone_medium_skin_tone\"\n ): \"👨🏼‍❤‍👨🏽\",\n \"couple_with_heart_man_man_medium_skin_tone\": \"👨🏽‍❤‍👨🏽\",\n \"couple_with_heart_man_man_medium_skin_tone_dark_skin_tone\": \"👨🏽‍❤‍👨🏿\",\n \"couple_with_heart_man_man_medium_skin_tone_light_skin_tone\": \"👨🏽‍❤‍👨🏻\",\n (\n \"couple_with_heart_man_man_medium_skin_tone_medium-dark_skin_tone\"\n ): \"👨🏽‍❤‍👨🏾\",\n (\n \"couple_with_heart_man_man_medium_skin_tone_medium-light_skin_tone\"\n ): \"👨🏽‍❤‍👨🏼\",\n \"couple_with_heart_medium-dark_skin_tone\": \"💑🏾\",\n \"couple_with_heart_medium-light_skin_tone\": \"💑🏼\",\n \"couple_with_heart_medium_skin_tone\": \"💑🏽\",\n (\n \"couple_with_heart_person_person_dark_skin_tone_light_skin_tone\"\n ): \"🧑🏿‍❤‍🧑🏻\",\n (\n \"couple_with_heart_person_person_dark_skin_tone_medium-dark_skin_tone\"\n ): \"🧑🏿‍❤‍🧑🏾\",\n (\n \"couple_with_heart_person_person_dark_skin_tone_medium-light_skin_tone\"\n ): \"🧑🏿‍❤‍🧑🏼\",\n (\n \"couple_with_heart_person_person_dark_skin_tone_medium_skin_tone\"\n ): \"🧑🏿‍❤‍🧑🏽\",\n (\n \"couple_with_heart_person_person_light_skin_tone_dark_skin_tone\"\n ): \"🧑🏻‍❤‍🧑🏿\",\n (\n \"couple_with_heart_person_person_light_skin_tone_medium-dark_skin_tone\"\n ): \"🧑🏻‍❤‍🧑🏾\",\n (\n \"couple_with_heart_person_person_\"\n \"light_skin_tone_medium-light_skin_tone\"\n ): \"🧑🏻‍❤‍🧑🏼\",\n (\n \"couple_with_heart_person_person_light_skin_tone_medium_skin_tone\"\n ): \"🧑🏻‍❤‍🧑🏽\",\n (\n \"couple_with_heart_person_person_medium-dark_skin_tone_dark_skin_tone\"\n ): \"🧑🏾‍❤‍🧑🏿\",\n (\n \"couple_with_heart_person_person_medium-dark_skin_tone_light_skin_tone\"\n ): \"🧑🏾‍❤‍🧑🏻\",\n (\n \"couple_with_heart_person_person_medium\"\n \"-dark_skin_tone_medium-light_skin_tone\"\n ): \"🧑🏾‍❤‍🧑🏼\",\n (\n \"couple_with_heart_person_person\"\n \"_medium-dark_skin_tone_medium_skin_tone\"\n ): \"🧑🏾‍❤‍🧑🏽\",\n (\n \"couple_with_heart_person_person_medium-light_skin_tone_dark_skin_tone\"\n ): \"🧑🏼‍❤‍🧑🏿\",\n (\n \"couple_with_heart_person_person\"\n \"_medium-light_skin_tone_light_skin_tone\"\n ): \"🧑🏼‍❤‍🧑🏻\",\n (\n \"couple_with_heart_person_person_medium\"\n \"-light_skin_tone_medium-dark_skin_tone\"\n ): \"🧑🏼‍❤‍🧑🏾\",\n (\n \"couple_with_heart_person_person\"\n \"_medium-light_skin_tone_medium_skin_tone\"\n ): \"🧑🏼‍❤‍🧑🏽\",\n (\n \"couple_with_heart_person_person_medium_skin_tone_dark_skin_tone\"\n ): \"🧑🏽‍❤‍🧑🏿\",\n (\n \"couple_with_heart_person_person_medium_skin_tone_light_skin_tone\"\n ): \"🧑🏽‍❤‍🧑🏻\",\n (\n \"couple_with_heart_person_person\"\n \"_medium_skin_tone_medium-dark_skin_tone\"\n ): \"🧑🏽‍❤‍🧑🏾\",\n (\n \"couple_with_heart_person_person\"\n \"_medium_skin_tone_medium-light_skin_tone\"\n ): \"🧑🏽‍❤‍🧑🏼\",\n \"couple_with_heart_woman_man\": \"👩‍❤‍👨\",\n \"couple_with_heart_woman_man_dark_skin_tone\": \"👩🏿‍❤‍👨🏿\",\n \"couple_with_heart_woman_man_dark_skin_tone_light_skin_tone\": \"👩🏿‍❤‍👨🏻\",\n (\n \"couple_with_heart_woman_man_dark_skin_tone_medium-dark_skin_tone\"\n ): \"👩🏿‍❤‍👨🏾\",\n (\n \"couple_with_heart_woman_man_dark_skin_tone_medium-light_skin_tone\"\n ): \"👩🏿‍❤‍👨🏼\",\n \"couple_with_heart_woman_man_dark_skin_tone_medium_skin_tone\": \"👩🏿‍❤‍👨🏽\",\n \"couple_with_heart_woman_man_light_skin_tone\": \"👩🏻‍❤‍👨🏻\",\n \"couple_with_heart_woman_man_light_skin_tone_dark_skin_tone\": \"👩🏻‍❤‍👨🏿\",\n (\n \"couple_with_heart_woman_man_light_skin_tone_medium-dark_skin_tone\"\n ): \"👩🏻‍❤‍👨🏾\",\n (\n \"couple_with_heart_woman_man_light_skin_tone_medium-light_skin_tone\"\n ): \"👩🏻‍❤‍👨🏼\",\n (\n \"couple_with_heart_woman_man_light_skin_tone_medium_skin_tone\"\n ): \"👩🏻‍❤‍👨🏽\",\n \"couple_with_heart_woman_man_medium-dark_skin_tone\": \"👩🏾‍❤‍👨🏾\",\n (\n \"couple_with_heart_woman_man_medium-dark_skin_tone_dark_skin_tone\"\n ): \"👩🏾‍❤‍👨🏿\",\n (\n \"couple_with_heart_woman_man_medium-dark_skin_tone_light_skin_tone\"\n ): \"👩🏾‍❤‍👨🏻\",\n (\n \"couple_with_heart_woman_man_medium\"\n \"-dark_skin_tone_medium-light_skin_tone\"\n ): \"👩🏾‍❤‍👨🏼\",\n (\n \"couple_with_heart_woman_man_medium-dark_skin_tone_medium_skin_tone\"\n ): \"👩🏾‍❤‍👨🏽\",\n \"couple_with_heart_woman_man_medium-light_skin_tone\": \"👩🏼‍❤‍👨🏼\",\n (\n \"couple_with_heart_woman_man_medium-light_skin_tone_dark_skin_tone\"\n ): \"👩🏼‍❤‍👨🏿\",\n (\n \"couple_with_heart_woman_man_medium-light_skin_tone_light_skin_tone\"\n ): \"👩🏼‍❤‍👨🏻\",\n (\n \"couple_with_heart_woman_man_medium\"\n \"-light_skin_tone_medium-dark_skin_tone\"\n ): \"👩🏼‍❤‍👨🏾\",\n (\n \"couple_with_heart_woman_man_medium-light_skin_tone_medium_skin_tone\"\n ): \"👩🏼‍❤‍👨🏽\",\n \"couple_with_heart_woman_man_medium_skin_tone\": \"👩🏽‍❤‍👨🏽\",\n \"couple_with_heart_woman_man_medium_skin_tone_dark_skin_tone\": \"👩🏽‍❤‍👨🏿\",\n (\n \"couple_with_heart_woman_man_medium_skin_tone_light_skin_tone\"\n ): \"👩🏽‍❤‍👨🏻\",\n (\n \"couple_with_heart_woman_man_medium_skin_tone_medium-dark_skin_tone\"\n ): \"👩🏽‍❤‍👨🏾\",\n (\n \"couple_with_heart_woman_man_medium_skin_tone_medium-light_skin_tone\"\n ): \"👩🏽‍❤‍👨🏼\",\n \"couple_with_heart_woman_woman\": \"👩‍❤‍👩\",\n \"couple_with_heart_woman_woman_dark_skin_tone\": \"👩🏿‍❤‍👩🏿\",\n (\n \"couple_with_heart_woman_woman_dark_skin_tone_light_skin_tone\"\n ): \"👩🏿‍❤‍👩🏻\",\n (\n \"couple_with_heart_woman_woman_dark_skin_tone_medium-dark_skin_tone\"\n ): \"👩🏿‍❤‍👩🏾\",\n (\n \"couple_with_heart_woman_woman_dark_skin_tone_medium-light_skin_tone\"\n ): \"👩🏿‍❤‍👩🏼\",\n (\n \"couple_with_heart_woman_woman_dark_skin_tone_medium_skin_tone\"\n ): \"👩🏿‍❤‍👩🏽\",\n \"couple_with_heart_woman_woman_light_skin_tone\": \"👩🏻‍❤‍👩🏻\",\n (\n \"couple_with_heart_woman_woman_light_skin_tone_dark_skin_tone\"\n ): \"👩🏻‍❤‍👩🏿\",\n (\n \"couple_with_heart_woman_woman_light_skin_tone_medium-dark_skin_tone\"\n ): \"👩🏻‍❤‍👩🏾\",\n (\n \"couple_with_heart_woman_woman_light_skin_tone_medium-light_skin_tone\"\n ): \"👩🏻‍❤‍👩🏼\",\n (\n \"couple_with_heart_woman_woman_light_skin_tone_medium_skin_tone\"\n ): \"👩🏻‍❤‍👩🏽\",\n \"couple_with_heart_woman_woman_medium-dark_skin_tone\": \"👩🏾‍❤‍👩🏾\",\n (\n \"couple_with_heart_woman_woman_medium-dark_skin_tone_dark_skin_tone\"\n ): \"👩🏾‍❤‍👩🏿\",\n (\n \"couple_with_heart_woman_woman_medium-dark_skin_tone_light_skin_tone\"\n ): \"👩🏾‍❤‍👩🏻\",\n (\n \"couple_with_heart_woman_woman_medium\"\n \"-dark_skin_tone_medium-light_skin_tone\"\n ): \"👩🏾‍❤‍👩🏼\",\n (\n \"couple_with_heart_woman_woman_medium-dark_skin_tone_medium_skin_tone\"\n ): \"👩🏾‍❤‍👩🏽\",\n \"couple_with_heart_woman_woman_medium-light_skin_tone\": \"👩🏼‍❤‍👩🏼\",\n (\n \"couple_with_heart_woman_woman_medium-light_skin_tone_dark_skin_tone\"\n ): \"👩🏼‍❤‍👩🏿\",\n (\n \"couple_with_heart_woman_woman_medium-light_skin_tone_light_skin_tone\"\n ): \"👩🏼‍❤‍👩🏻\",\n (\n \"couple_with_heart_woman_woman_medium\"\n \"-light_skin_tone_medium-dark_skin_tone\"\n ): \"👩🏼‍❤‍👩🏾\",\n (\n \"couple_with_heart_woman_woman_medium-light_skin_tone_medium_skin_tone\"\n ): \"👩🏼‍❤‍👩🏽\",\n \"couple_with_heart_woman_woman_medium_skin_tone\": \"👩🏽‍❤‍👩🏽\",\n (\n \"couple_with_heart_woman_woman_medium_skin_tone_dark_skin_tone\"\n ): \"👩🏽‍❤‍👩🏿\",\n (\n \"couple_with_heart_woman_woman_medium_skin_tone_light_skin_tone\"\n ): \"👩🏽‍❤‍👩🏻\",\n (\n \"couple_with_heart_woman_woman_medium_skin_tone_medium-dark_skin_tone\"\n ): \"👩🏽‍❤‍👩🏾\",\n (\n \"couple_with_heart_woman_woman_medium_skin_tone_medium-light_skin_tone\"\n ): \"👩🏽‍❤‍👩🏼\",\n \"cow\": \"🐄\",\n \"cow_face\": \"🐮\",\n \"cowboy_hat_face\": \"🤠\",\n \"crab\": \"🦀\",\n \"crayon\": \"🖍\",\n \"credit_card\": \"💳\",\n \"crescent_moon\": \"🌙\",\n \"cricket\": \"🦗\",\n \"cricket_game\": \"🏏\",\n \"crocodile\": \"🐊\",\n \"croissant\": \"🥐\",\n \"cross_mark\": \"❌\",\n \"cross_mark_button\": \"❎\",\n \"crossed_fingers\": \"🤞\",\n \"crossed_fingers_dark_skin_tone\": \"🤞🏿\",\n \"crossed_fingers_light_skin_tone\": \"🤞🏻\",\n \"crossed_fingers_medium-dark_skin_tone\": \"🤞🏾\",\n \"crossed_fingers_medium-light_skin_tone\": \"🤞🏼\",\n \"crossed_fingers_medium_skin_tone\": \"🤞🏽\",\n \"crossed_flags\": \"🎌\",\n \"crossed_swords\": \"⚔\",\n \"crown\": \"👑\",\n \"crutch\": \"🩼\",\n \"crying_cat\": \"😿\",\n \"crying_face\": \"😢\",\n \"crystal_ball\": \"🔮\",\n \"cucumber\": \"🥒\",\n \"cup_with_straw\": \"🥤\",\n \"cupcake\": \"🧁\",\n \"curling_stone\": \"🥌\",\n \"curly_hair\": \"🦱\",\n \"curly_loop\": \"➰\",\n \"currency_exchange\": \"💱\",\n \"curry_rice\": \"🍛\",\n \"custard\": \"🍮\",\n \"customs\": \"🛃\",\n \"cut_of_meat\": \"🥩\",\n \"cyclone\": \"🌀\",\n \"dagger\": \"🗡\",\n \"dango\": \"🍡\",\n \"dark_skin_tone\": \"🏿\",\n \"dashing_away\": \"💨\",\n \"deaf_man\": \"🧏‍♂\",\n \"deaf_man_dark_skin_tone\": \"🧏🏿‍♂\",\n \"deaf_man_light_skin_tone\": \"🧏🏻‍♂\",\n \"deaf_man_medium-dark_skin_tone\": \"🧏🏾‍♂\",\n \"deaf_man_medium-light_skin_tone\": \"🧏🏼‍♂\",\n \"deaf_man_medium_skin_tone\": \"🧏🏽‍♂\",\n \"deaf_person\": \"🧏\",\n \"deaf_person_dark_skin_tone\": \"🧏🏿\",\n \"deaf_person_light_skin_tone\": \"🧏🏻\",\n \"deaf_person_medium-dark_skin_tone\": \"🧏🏾\",\n \"deaf_person_medium-light_skin_tone\": \"🧏🏼\",\n \"deaf_person_medium_skin_tone\": \"🧏🏽\",\n \"deaf_woman\": \"🧏‍♀\",\n \"deaf_woman_dark_skin_tone\": \"🧏🏿‍♀\",\n \"deaf_woman_light_skin_tone\": \"🧏🏻‍♀\",\n \"deaf_woman_medium-dark_skin_tone\": \"🧏🏾‍♀\",\n \"deaf_woman_medium-light_skin_tone\": \"🧏🏼‍♀\",\n \"deaf_woman_medium_skin_tone\": \"🧏🏽‍♀\",\n \"deciduous_tree\": \"🌳\",\n \"deer\": \"🦌\",\n \"delivery_truck\": \"🚚\",\n \"department_store\": \"🏬\",\n \"derelict_house\": \"🏚\",\n \"desert\": \"🏜\",\n \"desert_island\": \"🏝\",\n \"desktop_computer\": \"🖥\",\n \"detective\": \"🕵\",\n \"detective_dark_skin_tone\": \"🕵🏿\",\n \"detective_light_skin_tone\": \"🕵🏻\",\n \"detective_medium-dark_skin_tone\": \"🕵🏾\",\n \"detective_medium-light_skin_tone\": \"🕵🏼\",\n \"detective_medium_skin_tone\": \"🕵🏽\",\n \"diamond_suit\": \"♦\",\n \"diamond_with_a_dot\": \"💠\",\n \"dim_button\": \"🔅\",\n \"disappointed_face\": \"😞\",\n \"disguised_face\": \"🥸\",\n \"divide\": \"➗\",\n \"diving_mask\": \"🤿\",\n \"diya_lamp\": \"🪔\",\n \"dizzy\": \"💫\",\n \"dna\": \"🧬\",\n \"dodo\": \"🦤\",\n \"dog\": \"🐕\",\n \"dog_face\": \"🐶\",\n \"dollar_banknote\": \"💵\",\n \"dolphin\": \"🐬\",\n \"donkey\": \"🫏\",\n \"door\": \"🚪\",\n \"dotted_line_face\": \"🫥\",\n \"dotted_six-pointed_star\": \"🔯\",\n \"double_curly_loop\": \"➿\",\n \"double_exclamation_mark\": \"‼\",\n \"doughnut\": \"🍩\",\n \"dove\": \"🕊\",\n \"down-left_arrow\": \"↙\",\n \"down-right_arrow\": \"↘\",\n \"down_arrow\": \"⬇\",\n \"downcast_face_with_sweat\": \"😓\",\n \"downwards_button\": \"🔽\",\n \"dragon\": \"🐉\",\n \"dragon_face\": \"🐲\",\n \"dress\": \"👗\",\n \"drooling_face\": \"🤤\",\n \"drop_of_blood\": \"🩸\",\n \"droplet\": \"💧\",\n \"drum\": \"🥁\",\n \"duck\": \"🦆\",\n \"dumpling\": \"🥟\",\n \"dvd\": \"📀\",\n \"e-mail\": \"📧\",\n \"eagle\": \"🦅\",\n \"ear\": \"👂\",\n \"ear_dark_skin_tone\": \"👂🏿\",\n \"ear_light_skin_tone\": \"👂🏻\",\n \"ear_medium-dark_skin_tone\": \"👂🏾\",\n \"ear_medium-light_skin_tone\": \"👂🏼\",\n \"ear_medium_skin_tone\": \"👂🏽\",\n \"ear_of_corn\": \"🌽\",\n \"ear_with_hearing_aid\": \"🦻\",\n \"ear_with_hearing_aid_dark_skin_tone\": \"🦻🏿\",\n \"ear_with_hearing_aid_light_skin_tone\": \"🦻🏻\",\n \"ear_with_hearing_aid_medium-dark_skin_tone\": \"🦻🏾\",\n \"ear_with_hearing_aid_medium-light_skin_tone\": \"🦻🏼\",\n \"ear_with_hearing_aid_medium_skin_tone\": \"🦻🏽\",\n \"egg\": \"🥚\",\n \"eggplant\": \"🍆\",\n \"eight-pointed_star\": \"✴\",\n \"eight-spoked_asterisk\": \"✳\",\n \"eight-thirty\": \"🕣\",\n \"eight_o’clock\": \"🕗\",\n \"eject_button\": \"⏏\",\n \"electric_plug\": \"🔌\",\n \"elephant\": \"🐘\",\n \"elevator\": \"🛗\",\n \"eleven-thirty\": \"🕦\",\n \"eleven_o’clock\": \"🕚\",\n \"elf\": \"🧝\",\n \"elf_dark_skin_tone\": \"🧝🏿\",\n \"elf_light_skin_tone\": \"🧝🏻\",\n \"elf_medium-dark_skin_tone\": \"🧝🏾\",\n \"elf_medium-light_skin_tone\": \"🧝🏼\",\n \"elf_medium_skin_tone\": \"🧝🏽\",\n \"empty_nest\": \"🪹\",\n \"enraged_face\": \"😡\",\n \"envelope\": \"✉\",\n \"envelope_with_arrow\": \"📩\",\n \"euro_banknote\": \"💶\",\n \"evergreen_tree\": \"🌲\",\n \"ewe\": \"🐑\",\n \"exclamation_question_mark\": \"⁉\",\n \"exploding_head\": \"🤯\",\n \"expressionless_face\": \"😑\",\n \"eye\": \"👁\",\n \"eye_in_speech_bubble\": \"👁‍🗨\",\n \"eyes\": \"👀\",\n \"face_blowing_a_kiss\": \"😘\",\n \"face_exhaling\": \"😮‍💨\",\n \"face_holding_back_tears\": \"🥹\",\n \"face_in_clouds\": \"😶‍🌫\",\n \"face_savoring_food\": \"😋\",\n \"face_screaming_in_fear\": \"😱\",\n \"face_vomiting\": \"🤮\",\n \"face_with_crossed-out_eyes\": \"😵\",\n \"face_with_diagonal_mouth\": \"🫤\",\n \"face_with_hand_over_mouth\": \"🤭\",\n \"face_with_head-bandage\": \"🤕\",\n \"face_with_medical_mask\": \"😷\",\n \"face_with_monocle\": \"🧐\",\n \"face_with_open_eyes_and_hand_over_mouth\": \"🫢\",\n \"face_with_open_mouth\": \"😮\",\n \"face_with_peeking_eye\": \"🫣\",\n \"face_with_raised_eyebrow\": \"🤨\",\n \"face_with_rolling_eyes\": \"🙄\",\n \"face_with_spiral_eyes\": \"😵‍💫\",\n \"face_with_steam_from_nose\": \"😤\",\n \"face_with_symbols_on_mouth\": \"🤬\",\n \"face_with_tears_of_joy\": \"😂\",\n \"face_with_thermometer\": \"🤒\",\n \"face_with_tongue\": \"😛\",\n \"face_without_mouth\": \"😶\",\n \"factory\": \"🏭\",\n \"factory_worker\": \"🧑‍🏭\",\n \"factory_worker_dark_skin_tone\": \"🧑🏿‍🏭\",\n \"factory_worker_light_skin_tone\": \"🧑🏻‍🏭\",\n \"factory_worker_medium-dark_skin_tone\": \"🧑🏾‍🏭\",\n \"factory_worker_medium-light_skin_tone\": \"🧑🏼‍🏭\",\n \"factory_worker_medium_skin_tone\": \"🧑🏽‍🏭\",\n \"fairy\": \"🧚\",\n \"fairy_dark_skin_tone\": \"🧚🏿\",\n \"fairy_light_skin_tone\": \"🧚🏻\",\n \"fairy_medium-dark_skin_tone\": \"🧚🏾\",\n \"fairy_medium-light_skin_tone\": \"🧚🏼\",\n \"fairy_medium_skin_tone\": \"🧚🏽\",\n \"falafel\": \"🧆\",\n \"fallen_leaf\": \"🍂\",\n \"family\": \"👪\",\n \"family_man_boy\": \"👨‍👦\",\n \"family_man_boy_boy\": \"👨‍👦‍👦\",\n \"family_man_girl\": \"👨‍👧\",\n \"family_man_girl_boy\": \"👨‍👧‍👦\",\n \"family_man_girl_girl\": \"👨‍👧‍👧\",\n \"family_man_man_boy\": \"👨‍👨‍👦\",\n \"family_man_man_boy_boy\": \"👨‍👨‍👦‍👦\",\n \"family_man_man_girl\": \"👨‍👨‍👧\",\n \"family_man_man_girl_boy\": \"👨‍👨‍👧‍👦\",\n \"family_man_man_girl_girl\": \"👨‍👨‍👧‍👧\",\n \"family_man_woman_boy\": \"👨‍👩‍👦\",\n \"family_man_woman_boy_boy\": \"👨‍👩‍👦‍👦\",\n \"family_man_woman_girl\": \"👨‍👩‍👧\",\n \"family_man_woman_girl_boy\": \"👨‍👩‍👧‍👦\",\n \"family_man_woman_girl_girl\": \"👨‍👩‍👧‍👧\",\n \"family_woman_boy\": \"👩‍👦\",\n \"family_woman_boy_boy\": \"👩‍👦‍👦\",\n \"family_woman_girl\": \"👩‍👧\",\n \"family_woman_girl_boy\": \"👩‍👧‍👦\",\n \"family_woman_girl_girl\": \"👩‍👧‍👧\",\n \"family_woman_woman_boy\": \"👩‍👩‍👦\",\n \"family_woman_woman_boy_boy\": \"👩‍👩‍👦‍👦\",\n \"family_woman_woman_girl\": \"👩‍👩‍👧\",\n \"family_woman_woman_girl_boy\": \"👩‍👩‍👧‍👦\",\n \"family_woman_woman_girl_girl\": \"👩‍👩‍👧‍👧\",\n \"farmer\": \"🧑‍🌾\",\n \"farmer_dark_skin_tone\": \"🧑🏿‍🌾\",\n \"farmer_light_skin_tone\": \"🧑🏻‍🌾\",\n \"farmer_medium-dark_skin_tone\": \"🧑🏾‍🌾\",\n \"farmer_medium-light_skin_tone\": \"🧑🏼‍🌾\",\n \"farmer_medium_skin_tone\": \"🧑🏽‍🌾\",\n \"fast-forward_button\": \"⏩\",\n \"fast_down_button\": \"⏬\",\n \"fast_reverse_button\": \"⏪\",\n \"fast_up_button\": \"⏫\",\n \"fax_machine\": \"📠\",\n \"fearful_face\": \"😨\",\n \"feather\": \"🪶\",\n \"female_sign\": \"♀\",\n \"ferris_wheel\": \"🎡\",\n \"ferry\": \"⛴\",\n \"field_hockey\": \"🏑\",\n \"file_cabinet\": \"🗄\",\n \"file_folder\": \"📁\",\n \"film_frames\": \"🎞\",\n \"film_projector\": \"📽\",\n \"fire\": \"🔥\",\n \"fire_engine\": \"🚒\",\n \"fire_extinguisher\": \"🧯\",\n \"firecracker\": \"🧨\",\n \"firefighter\": \"🧑‍🚒\",\n \"firefighter_dark_skin_tone\": \"🧑🏿‍🚒\",\n \"firefighter_light_skin_tone\": \"🧑🏻‍🚒\",\n \"firefighter_medium-dark_skin_tone\": \"🧑🏾‍🚒\",\n \"firefighter_medium-light_skin_tone\": \"🧑🏼‍🚒\",\n \"firefighter_medium_skin_tone\": \"🧑🏽‍🚒\",\n \"fireworks\": \"🎆\",\n \"first_quarter_moon\": \"🌓\",\n \"first_quarter_moon_face\": \"🌛\",\n \"fish\": \"🐟\",\n \"fish_cake_with_swirl\": \"🍥\",\n \"fishing_pole\": \"🎣\",\n \"five-thirty\": \"🕠\",\n \"five_o’clock\": \"🕔\",\n \"flag_in_hole\": \"⛳\",\n \"flamingo\": \"🦩\",\n \"flashlight\": \"🔦\",\n \"flat_shoe\": \"🥿\",\n \"flatbread\": \"🫓\",\n \"fleur-de-lis\": \"⚜\",\n \"flexed_biceps\": \"💪\",\n \"flexed_biceps_dark_skin_tone\": \"💪🏿\",\n \"flexed_biceps_light_skin_tone\": \"💪🏻\",\n \"flexed_biceps_medium-dark_skin_tone\": \"💪🏾\",\n \"flexed_biceps_medium-light_skin_tone\": \"💪🏼\",\n \"flexed_biceps_medium_skin_tone\": \"💪🏽\",\n \"floppy_disk\": \"💾\",\n \"flower_playing_cards\": \"🎴\",\n \"flushed_face\": \"😳\",\n \"flute\": \"🪈\",\n \"fly\": \"🪰\",\n \"flying_disc\": \"🥏\",\n \"flying_saucer\": \"🛸\",\n \"fog\": \"🌫\",\n \"foggy\": \"🌁\",\n \"folded_hands\": \"🙏\",\n \"folded_hands_dark_skin_tone\": \"🙏🏿\",\n \"folded_hands_light_skin_tone\": \"🙏🏻\",\n \"folded_hands_medium-dark_skin_tone\": \"🙏🏾\",\n \"folded_hands_medium-light_skin_tone\": \"🙏🏼\",\n \"folded_hands_medium_skin_tone\": \"🙏🏽\",\n \"folding_hand_fan\": \"🪭\",\n \"fondue\": \"🫕\",\n \"foot\": \"🦶\",\n \"foot_dark_skin_tone\": \"🦶🏿\",\n \"foot_light_skin_tone\": \"🦶🏻\",\n \"foot_medium-dark_skin_tone\": \"🦶🏾\",\n \"foot_medium-light_skin_tone\": \"🦶🏼\",\n \"foot_medium_skin_tone\": \"🦶🏽\",\n \"footprints\": \"👣\",\n \"fork_and_knife\": \"🍴\",\n \"fork_and_knife_with_plate\": \"🍽\",\n \"fortune_cookie\": \"🥠\",\n \"fountain\": \"⛲\",\n \"fountain_pen\": \"🖋\",\n \"four-thirty\": \"🕟\",\n \"four_leaf_clover\": \"🍀\",\n \"four_o’clock\": \"🕓\",\n \"fox\": \"🦊\",\n \"framed_picture\": \"🖼\",\n \"french_fries\": \"🍟\",\n \"fried_shrimp\": \"🍤\",\n \"frog\": \"🐸\",\n \"front-facing_baby_chick\": \"🐥\",\n \"frowning_face\": \"☹\",\n \"frowning_face_with_open_mouth\": \"😦\",\n \"fuel_pump\": \"⛽\",\n \"full_moon\": \"🌕\",\n \"full_moon_face\": \"🌝\",\n \"funeral_urn\": \"⚱\",\n \"game_die\": \"🎲\",\n \"garlic\": \"🧄\",\n \"gear\": \"⚙\",\n \"gem_stone\": \"💎\",\n \"genie\": \"🧞\",\n \"ghost\": \"👻\",\n \"ginger_root\": \"🫚\",\n \"giraffe\": \"🦒\",\n \"girl\": \"👧\",\n \"girl_dark_skin_tone\": \"👧🏿\",\n \"girl_light_skin_tone\": \"👧🏻\",\n \"girl_medium-dark_skin_tone\": \"👧🏾\",\n \"girl_medium-light_skin_tone\": \"👧🏼\",\n \"girl_medium_skin_tone\": \"👧🏽\",\n \"glass_of_milk\": \"🥛\",\n \"glasses\": \"👓\",\n \"globe_showing_Americas\": \"🌎\",\n \"globe_showing_Asia-Australia\": \"🌏\",\n \"globe_showing_Europe-Africa\": \"🌍\",\n \"globe_with_meridians\": \"🌐\",\n \"gloves\": \"🧤\",\n \"glowing_star\": \"🌟\",\n \"goal_net\": \"🥅\",\n \"goat\": \"🐐\",\n \"goblin\": \"👺\",\n \"goggles\": \"🥽\",\n \"goose\": \"🪿\",\n \"gorilla\": \"🦍\",\n \"graduation_cap\": \"🎓\",\n \"grapes\": \"🍇\",\n \"green_apple\": \"🍏\",\n \"green_book\": \"📗\",\n \"green_circle\": \"🟢\",\n \"green_heart\": \"💚\",\n \"green_salad\": \"🥗\",\n \"green_square\": \"🟩\",\n \"grey_heart\": \"🩶\",\n \"grimacing_face\": \"😬\",\n \"grinning_cat\": \"😺\",\n \"grinning_cat_with_smiling_eyes\": \"😸\",\n \"grinning_face\": \"😀\",\n \"grinning_face_with_big_eyes\": \"😃\",\n \"grinning_face_with_smiling_eyes\": \"😄\",\n \"grinning_face_with_sweat\": \"😅\",\n \"grinning_squinting_face\": \"😆\",\n \"growing_heart\": \"💗\",\n \"guard\": \"💂\",\n \"guard_dark_skin_tone\": \"💂🏿\",\n \"guard_light_skin_tone\": \"💂🏻\",\n \"guard_medium-dark_skin_tone\": \"💂🏾\",\n \"guard_medium-light_skin_tone\": \"💂🏼\",\n \"guard_medium_skin_tone\": \"💂🏽\",\n \"guide_dog\": \"🦮\",\n \"guitar\": \"🎸\",\n \"hair_pick\": \"🪮\",\n \"hamburger\": \"🍔\",\n \"hammer\": \"🔨\",\n \"hammer_and_pick\": \"⚒\",\n \"hammer_and_wrench\": \"🛠\",\n \"hamsa\": \"🪬\",\n \"hamster\": \"🐹\",\n \"hand_with_fingers_splayed\": \"🖐\",\n \"hand_with_fingers_splayed_dark_skin_tone\": \"🖐🏿\",\n \"hand_with_fingers_splayed_light_skin_tone\": \"🖐🏻\",\n \"hand_with_fingers_splayed_medium-dark_skin_tone\": \"🖐🏾\",\n \"hand_with_fingers_splayed_medium-light_skin_tone\": \"🖐🏼\",\n \"hand_with_fingers_splayed_medium_skin_tone\": \"🖐🏽\",\n \"hand_with_index_finger_and_thumb_crossed\": \"🫰\",\n \"hand_with_index_finger_and_thumb_crossed_dark_skin_tone\": \"🫰🏿\",\n \"hand_with_index_finger_and_thumb_crossed_light_skin_tone\": \"🫰🏻\",\n \"hand_with_index_finger_and_thumb_crossed_medium-dark_skin_tone\": \"🫰🏾\",\n \"hand_with_index_finger_and_thumb_crossed_medium-light_skin_tone\": \"🫰🏼\",\n \"hand_with_index_finger_and_thumb_crossed_medium_skin_tone\": \"🫰🏽\",\n \"handbag\": \"👜\",\n \"handshake\": \"🤝\",\n \"handshake_dark_skin_tone\": \"🤝🏿\",\n \"handshake_dark_skin_tone_light_skin_tone\": \"🫱🏿‍🫲🏻\",\n \"handshake_dark_skin_tone_medium-dark_skin_tone\": \"🫱🏿‍🫲🏾\",\n \"handshake_dark_skin_tone_medium-light_skin_tone\": \"🫱🏿‍🫲🏼\",\n \"handshake_dark_skin_tone_medium_skin_tone\": \"🫱🏿‍🫲🏽\",\n \"handshake_light_skin_tone\": \"🤝🏻\",\n \"handshake_light_skin_tone_dark_skin_tone\": \"🫱🏻‍🫲🏿\",\n \"handshake_light_skin_tone_medium-dark_skin_tone\": \"🫱🏻‍🫲🏾\",\n \"handshake_light_skin_tone_medium-light_skin_tone\": \"🫱🏻‍🫲🏼\",\n \"handshake_light_skin_tone_medium_skin_tone\": \"🫱🏻‍🫲🏽\",\n \"handshake_medium-dark_skin_tone\": \"🤝🏾\",\n \"handshake_medium-dark_skin_tone_dark_skin_tone\": \"🫱🏾‍🫲🏿\",\n \"handshake_medium-dark_skin_tone_light_skin_tone\": \"🫱🏾‍🫲🏻\",\n \"handshake_medium-dark_skin_tone_medium-light_skin_tone\": \"🫱🏾‍🫲🏼\",\n \"handshake_medium-dark_skin_tone_medium_skin_tone\": \"🫱🏾‍🫲🏽\",\n \"handshake_medium-light_skin_tone\": \"🤝🏼\",\n \"handshake_medium-light_skin_tone_dark_skin_tone\": \"🫱🏼‍🫲🏿\",\n \"handshake_medium-light_skin_tone_light_skin_tone\": \"🫱🏼‍🫲🏻\",\n \"handshake_medium-light_skin_tone_medium-dark_skin_tone\": \"🫱🏼‍🫲🏾\",\n \"handshake_medium-light_skin_tone_medium_skin_tone\": \"🫱🏼‍🫲🏽\",\n \"handshake_medium_skin_tone\": \"🤝🏽\",\n \"handshake_medium_skin_tone_dark_skin_tone\": \"🫱🏽‍🫲🏿\",\n \"handshake_medium_skin_tone_light_skin_tone\": \"🫱🏽‍🫲🏻\",\n \"handshake_medium_skin_tone_medium-dark_skin_tone\": \"🫱🏽‍🫲🏾\",\n \"handshake_medium_skin_tone_medium-light_skin_tone\": \"🫱🏽‍🫲🏼\",\n \"hatching_chick\": \"🐣\",\n \"headphone\": \"🎧\",\n \"headstone\": \"🪦\",\n \"health_worker\": \"🧑‍⚕\",\n \"health_worker_dark_skin_tone\": \"🧑🏿‍⚕\",\n \"health_worker_light_skin_tone\": \"🧑🏻‍⚕\",\n \"health_worker_medium-dark_skin_tone\": \"🧑🏾‍⚕\",\n \"health_worker_medium-light_skin_tone\": \"🧑🏼‍⚕\",\n \"health_worker_medium_skin_tone\": \"🧑🏽‍⚕\",\n \"hear-no-evil_monkey\": \"🙉\",\n \"heart_decoration\": \"💟\",\n \"heart_exclamation\": \"❣\",\n \"heart_hands\": \"🫶\",\n \"heart_hands_dark_skin_tone\": \"🫶🏿\",\n \"heart_hands_light_skin_tone\": \"🫶🏻\",\n \"heart_hands_medium-dark_skin_tone\": \"🫶🏾\",\n \"heart_hands_medium-light_skin_tone\": \"🫶🏼\",\n \"heart_hands_medium_skin_tone\": \"🫶🏽\",\n \"heart_on_fire\": \"❤‍🔥\",\n \"heart_suit\": \"♥\",\n \"heart_with_arrow\": \"💘\",\n \"heart_with_ribbon\": \"💝\",\n \"heavy_dollar_sign\": \"💲\",\n \"heavy_equals_sign\": \"🟰\",\n \"hedgehog\": \"🦔\",\n \"helicopter\": \"🚁\",\n \"herb\": \"🌿\",\n \"hibiscus\": \"🌺\",\n \"high-heeled_shoe\": \"👠\",\n \"high-speed_train\": \"🚄\",\n \"high_voltage\": \"⚡\",\n \"hiking_boot\": \"🥾\",\n \"hindu_temple\": \"🛕\",\n \"hippopotamus\": \"🦛\",\n \"hole\": \"🕳\",\n \"hollow_red_circle\": \"⭕\",\n \"honey_pot\": \"🍯\",\n \"honeybee\": \"🐝\",\n \"hook\": \"🪝\",\n \"horizontal_traffic_light\": \"🚥\",\n \"horse\": \"🐎\",\n \"horse_face\": \"🐴\",\n \"horse_racing\": \"🏇\",\n \"horse_racing_dark_skin_tone\": \"🏇🏿\",\n \"horse_racing_light_skin_tone\": \"🏇🏻\",\n \"horse_racing_medium-dark_skin_tone\": \"🏇🏾\",\n \"horse_racing_medium-light_skin_tone\": \"🏇🏼\",\n \"horse_racing_medium_skin_tone\": \"🏇🏽\",\n \"hospital\": \"🏥\",\n \"hot_beverage\": \"☕\",\n \"hot_dog\": \"🌭\",\n \"hot_face\": \"🥵\",\n \"hot_pepper\": \"🌶\",\n \"hot_springs\": \"♨\",\n \"hotel\": \"🏨\",\n \"hourglass_done\": \"⌛\",\n \"hourglass_not_done\": \"⏳\",\n \"house\": \"🏠\",\n \"house_with_garden\": \"🏡\",\n \"houses\": \"🏘\",\n \"hundred_points\": \"💯\",\n \"hushed_face\": \"😯\",\n \"hut\": \"🛖\",\n \"hyacinth\": \"🪻\",\n \"ice\": \"🧊\",\n \"ice_cream\": \"🍨\",\n \"ice_hockey\": \"🏒\",\n \"ice_skate\": \"⛸\",\n \"identification_card\": \"🪪\",\n \"inbox_tray\": \"📥\",\n \"incoming_envelope\": \"📨\",\n \"index_pointing_at_the_viewer\": \"🫵\",\n \"index_pointing_at_the_viewer_dark_skin_tone\": \"🫵🏿\",\n \"index_pointing_at_the_viewer_light_skin_tone\": \"🫵🏻\",\n \"index_pointing_at_the_viewer_medium-dark_skin_tone\": \"🫵🏾\",\n \"index_pointing_at_the_viewer_medium-light_skin_tone\": \"🫵🏼\",\n \"index_pointing_at_the_viewer_medium_skin_tone\": \"🫵🏽\",\n \"index_pointing_up\": \"☝\",\n \"index_pointing_up_dark_skin_tone\": \"☝🏿\",\n \"index_pointing_up_light_skin_tone\": \"☝🏻\",\n \"index_pointing_up_medium-dark_skin_tone\": \"☝🏾\",\n \"index_pointing_up_medium-light_skin_tone\": \"☝🏼\",\n \"index_pointing_up_medium_skin_tone\": \"☝🏽\",\n \"infinity\": \"♾\",\n \"information\": \"ℹ\",\n \"input_latin_letters\": \"🔤\",\n \"input_latin_lowercase\": \"🔡\",\n \"input_latin_uppercase\": \"🔠\",\n \"input_numbers\": \"🔢\",\n \"input_symbols\": \"🔣\",\n \"jack-o-lantern\": \"🎃\",\n \"jar\": \"🫙\",\n \"jeans\": \"👖\",\n \"jellyfish\": \"🪼\",\n \"joker\": \"🃏\",\n \"joystick\": \"🕹\",\n \"judge\": \"🧑‍⚖\",\n \"judge_dark_skin_tone\": \"🧑🏿‍⚖\",\n \"judge_light_skin_tone\": \"🧑🏻‍⚖\",\n \"judge_medium-dark_skin_tone\": \"🧑🏾‍⚖\",\n \"judge_medium-light_skin_tone\": \"🧑🏼‍⚖\",\n \"judge_medium_skin_tone\": \"🧑🏽‍⚖\",\n \"kaaba\": \"🕋\",\n \"kangaroo\": \"🦘\",\n \"key\": \"🔑\",\n \"keyboard\": \"⌨\",\n \"keycap_#\": \"#⃣\",\n \"keycap_*\": \"*⃣\",\n \"keycap_0\": \"0⃣\",\n \"keycap_1\": \"1⃣\",\n \"keycap_10\": \"🔟\",\n \"keycap_2\": \"2⃣\",\n \"keycap_3\": \"3⃣\",\n \"keycap_4\": \"4⃣\",\n \"keycap_5\": \"5⃣\",\n \"keycap_6\": \"6⃣\",\n \"keycap_7\": \"7⃣\",\n \"keycap_8\": \"8⃣\",\n \"keycap_9\": \"9⃣\",\n \"khanda\": \"🪯\",\n \"kick_scooter\": \"🛴\",\n \"kimono\": \"👘\",\n \"kiss\": \"💏\",\n \"kiss_dark_skin_tone\": \"💏🏿\",\n \"kiss_light_skin_tone\": \"💏🏻\",\n \"kiss_man_man\": \"👨‍❤‍💋‍👨\",\n \"kiss_man_man_dark_skin_tone\": \"👨🏿‍❤‍💋‍👨🏿\",\n \"kiss_man_man_dark_skin_tone_light_skin_tone\": \"👨🏿‍❤‍💋‍👨🏻\",\n \"kiss_man_man_dark_skin_tone_medium-dark_skin_tone\": \"👨🏿‍❤‍💋‍👨🏾\",\n \"kiss_man_man_dark_skin_tone_medium-light_skin_tone\": \"👨🏿‍❤‍💋‍👨🏼\",\n \"kiss_man_man_dark_skin_tone_medium_skin_tone\": \"👨🏿‍❤‍💋‍👨🏽\",\n \"kiss_man_man_light_skin_tone\": \"👨🏻‍❤‍💋‍👨🏻\",\n \"kiss_man_man_light_skin_tone_dark_skin_tone\": \"👨🏻‍❤‍💋‍👨🏿\",\n \"kiss_man_man_light_skin_tone_medium-dark_skin_tone\": \"👨🏻‍❤‍💋‍👨🏾\",\n \"kiss_man_man_light_skin_tone_medium-light_skin_tone\": \"👨🏻‍❤‍💋‍👨🏼\",\n \"kiss_man_man_light_skin_tone_medium_skin_tone\": \"👨🏻‍❤‍💋‍👨🏽\",\n \"kiss_man_man_medium-dark_skin_tone\": \"👨🏾‍❤‍💋‍👨🏾\",\n \"kiss_man_man_medium-dark_skin_tone_dark_skin_tone\": \"👨🏾‍❤‍💋‍👨🏿\",\n \"kiss_man_man_medium-dark_skin_tone_light_skin_tone\": \"👨🏾‍❤‍💋‍👨🏻\",\n \"kiss_man_man_medium-dark_skin_tone_medium-light_skin_tone\": \"👨🏾‍❤‍💋‍👨🏼\",\n \"kiss_man_man_medium-dark_skin_tone_medium_skin_tone\": \"👨🏾‍❤‍💋‍👨🏽\",\n \"kiss_man_man_medium-light_skin_tone\": \"👨🏼‍❤‍💋‍👨🏼\",\n \"kiss_man_man_medium-light_skin_tone_dark_skin_tone\": \"👨🏼‍❤‍💋‍👨🏿\",\n \"kiss_man_man_medium-light_skin_tone_light_skin_tone\": \"👨🏼‍❤‍💋‍👨🏻\",\n \"kiss_man_man_medium-light_skin_tone_medium-dark_skin_tone\": \"👨🏼‍❤‍💋‍👨🏾\",\n \"kiss_man_man_medium-light_skin_tone_medium_skin_tone\": \"👨🏼‍❤‍💋‍👨🏽\",\n \"kiss_man_man_medium_skin_tone\": \"👨🏽‍❤‍💋‍👨🏽\",\n \"kiss_man_man_medium_skin_tone_dark_skin_tone\": \"👨🏽‍❤‍💋‍👨🏿\",\n \"kiss_man_man_medium_skin_tone_light_skin_tone\": \"👨🏽‍❤‍💋‍👨🏻\",\n \"kiss_man_man_medium_skin_tone_medium-dark_skin_tone\": \"👨🏽‍❤‍💋‍👨🏾\",\n \"kiss_man_man_medium_skin_tone_medium-light_skin_tone\": \"👨🏽‍❤‍💋‍👨🏼\",\n \"kiss_mark\": \"💋\",\n \"kiss_medium-dark_skin_tone\": \"💏🏾\",\n \"kiss_medium-light_skin_tone\": \"💏🏼\",\n \"kiss_medium_skin_tone\": \"💏🏽\",\n \"kiss_person_person_dark_skin_tone_light_skin_tone\": \"🧑🏿‍❤‍💋‍🧑🏻\",\n \"kiss_person_person_dark_skin_tone_medium-dark_skin_tone\": \"🧑🏿‍❤‍💋‍🧑🏾\",\n \"kiss_person_person_dark_skin_tone_medium-light_skin_tone\": \"🧑🏿‍❤‍💋‍🧑🏼\",\n \"kiss_person_person_dark_skin_tone_medium_skin_tone\": \"🧑🏿‍❤‍💋‍🧑🏽\",\n \"kiss_person_person_light_skin_tone_dark_skin_tone\": \"🧑🏻‍❤‍💋‍🧑🏿\",\n \"kiss_person_person_light_skin_tone_medium-dark_skin_tone\": \"🧑🏻‍❤‍💋‍🧑🏾\",\n \"kiss_person_person_light_skin_tone_medium-light_skin_tone\": \"🧑🏻‍❤‍💋‍🧑🏼\",\n \"kiss_person_person_light_skin_tone_medium_skin_tone\": \"🧑🏻‍❤‍💋‍🧑🏽\",\n \"kiss_person_person_medium-dark_skin_tone_dark_skin_tone\": \"🧑🏾‍❤‍💋‍🧑🏿\",\n \"kiss_person_person_medium-dark_skin_tone_light_skin_tone\": \"🧑🏾‍❤‍💋‍🧑🏻\",\n (\n \"kiss_person_person_medium-dark_skin_tone_medium-light_skin_tone\"\n ): \"🧑🏾‍❤‍💋‍🧑🏼\",\n \"kiss_person_person_medium-dark_skin_tone_medium_skin_tone\": \"🧑🏾‍❤‍💋‍🧑🏽\",\n \"kiss_person_person_medium-light_skin_tone_dark_skin_tone\": \"🧑🏼‍❤‍💋‍🧑🏿\",\n \"kiss_person_person_medium-light_skin_tone_light_skin_tone\": \"🧑🏼‍❤‍💋‍🧑🏻\",\n (\n \"kiss_person_person_medium-light_skin_tone_medium-dark_skin_tone\"\n ): \"🧑🏼‍❤‍💋‍🧑🏾\",\n (\n \"kiss_person_person_medium-light_skin_tone_medium_skin_tone\"\n ): \"🧑🏼‍❤‍💋‍🧑🏽\",\n \"kiss_person_person_medium_skin_tone_dark_skin_tone\": \"🧑🏽‍❤‍💋‍🧑🏿\",\n \"kiss_person_person_medium_skin_tone_light_skin_tone\": \"🧑🏽‍❤‍💋‍🧑🏻\",\n \"kiss_person_person_medium_skin_tone_medium-dark_skin_tone\": \"🧑🏽‍❤‍💋‍🧑🏾\",\n (\n \"kiss_person_person_medium_skin_tone_medium-light_skin_tone\"\n ): \"🧑🏽‍❤‍💋‍🧑🏼\",\n \"kiss_woman_man\": \"👩‍❤‍💋‍👨\",\n \"kiss_woman_man_dark_skin_tone\": \"👩🏿‍❤‍💋‍👨🏿\",\n \"kiss_woman_man_dark_skin_tone_light_skin_tone\": \"👩🏿‍❤‍💋‍👨🏻\",\n \"kiss_woman_man_dark_skin_tone_medium-dark_skin_tone\": \"👩🏿‍❤‍💋‍👨🏾\",\n \"kiss_woman_man_dark_skin_tone_medium-light_skin_tone\": \"👩🏿‍❤‍💋‍👨🏼\",\n \"kiss_woman_man_dark_skin_tone_medium_skin_tone\": \"👩🏿‍❤‍💋‍👨🏽\",\n \"kiss_woman_man_light_skin_tone\": \"👩🏻‍❤‍💋‍👨🏻\",\n \"kiss_woman_man_light_skin_tone_dark_skin_tone\": \"👩🏻‍❤‍💋‍👨🏿\",\n \"kiss_woman_man_light_skin_tone_medium-dark_skin_tone\": \"👩🏻‍❤‍💋‍👨🏾\",\n \"kiss_woman_man_light_skin_tone_medium-light_skin_tone\": \"👩🏻‍❤‍💋‍👨🏼\",\n \"kiss_woman_man_light_skin_tone_medium_skin_tone\": \"👩🏻‍❤‍💋‍👨🏽\",\n \"kiss_woman_man_medium-dark_skin_tone\": \"👩🏾‍❤‍💋‍👨🏾\",\n \"kiss_woman_man_medium-dark_skin_tone_dark_skin_tone\": \"👩🏾‍❤‍💋‍👨🏿\",\n \"kiss_woman_man_medium-dark_skin_tone_light_skin_tone\": \"👩🏾‍❤‍💋‍👨🏻\",\n (\n \"kiss_woman_man_medium-dark_skin_tone_medium-light_skin_tone\"\n ): \"👩🏾‍❤‍💋‍👨🏼\",\n \"kiss_woman_man_medium-dark_skin_tone_medium_skin_tone\": \"👩🏾‍❤‍💋‍👨🏽\",\n \"kiss_woman_man_medium-light_skin_tone\": \"👩🏼‍❤‍💋‍👨🏼\",\n \"kiss_woman_man_medium-light_skin_tone_dark_skin_tone\": \"👩🏼‍❤‍💋‍👨🏿\",\n \"kiss_woman_man_medium-light_skin_tone_light_skin_tone\": \"👩🏼‍❤‍💋‍👨🏻\",\n (\n \"kiss_woman_man_medium-light_skin_tone_medium-dark_skin_tone\"\n ): \"👩🏼‍❤‍💋‍👨🏾\",\n \"kiss_woman_man_medium-light_skin_tone_medium_skin_tone\": \"👩🏼‍❤‍💋‍👨🏽\",\n \"kiss_woman_man_medium_skin_tone\": \"👩🏽‍❤‍💋‍👨🏽\",\n \"kiss_woman_man_medium_skin_tone_dark_skin_tone\": \"👩🏽‍❤‍💋‍👨🏿\",\n \"kiss_woman_man_medium_skin_tone_light_skin_tone\": \"👩🏽‍❤‍💋‍👨🏻\",\n \"kiss_woman_man_medium_skin_tone_medium-dark_skin_tone\": \"👩🏽‍❤‍💋‍👨🏾\",\n \"kiss_woman_man_medium_skin_tone_medium-light_skin_tone\": \"👩🏽‍❤‍💋‍👨🏼\",\n \"kiss_woman_woman\": \"👩‍❤‍💋‍👩\",\n \"kiss_woman_woman_dark_skin_tone\": \"👩🏿‍❤‍💋‍👩🏿\",\n \"kiss_woman_woman_dark_skin_tone_light_skin_tone\": \"👩🏿‍❤‍💋‍👩🏻\",\n \"kiss_woman_woman_dark_skin_tone_medium-dark_skin_tone\": \"👩🏿‍❤‍💋‍👩🏾\",\n \"kiss_woman_woman_dark_skin_tone_medium-light_skin_tone\": \"👩🏿‍❤‍💋‍👩🏼\",\n \"kiss_woman_woman_dark_skin_tone_medium_skin_tone\": \"👩🏿‍❤‍💋‍👩🏽\",\n \"kiss_woman_woman_light_skin_tone\": \"👩🏻‍❤‍💋‍👩🏻\",\n \"kiss_woman_woman_light_skin_tone_dark_skin_tone\": \"👩🏻‍❤‍💋‍👩🏿\",\n \"kiss_woman_woman_light_skin_tone_medium-dark_skin_tone\": \"👩🏻‍❤‍💋‍👩🏾\",\n \"kiss_woman_woman_light_skin_tone_medium-light_skin_tone\": \"👩🏻‍❤‍💋‍👩🏼\",\n \"kiss_woman_woman_light_skin_tone_medium_skin_tone\": \"👩🏻‍❤‍💋‍👩🏽\",\n \"kiss_woman_woman_medium-dark_skin_tone\": \"👩🏾‍❤‍💋‍👩🏾\",\n \"kiss_woman_woman_medium-dark_skin_tone_dark_skin_tone\": \"👩🏾‍❤‍💋‍👩🏿\",\n \"kiss_woman_woman_medium-dark_skin_tone_light_skin_tone\": \"👩🏾‍❤‍💋‍👩🏻\",\n (\n \"kiss_woman_woman_medium-dark_skin_tone_medium-light_skin_tone\"\n ): \"👩🏾‍❤‍💋‍👩🏼\",\n \"kiss_woman_woman_medium-dark_skin_tone_medium_skin_tone\": \"👩🏾‍❤‍💋‍👩🏽\",\n \"kiss_woman_woman_medium-light_skin_tone\": \"👩🏼‍❤‍💋‍👩🏼\",\n \"kiss_woman_woman_medium-light_skin_tone_dark_skin_tone\": \"👩🏼‍❤‍💋‍👩🏿\",\n \"kiss_woman_woman_medium-light_skin_tone_light_skin_tone\": \"👩🏼‍❤‍💋‍👩🏻\",\n (\n \"kiss_woman_woman_medium-light_skin_tone_medium-dark_skin_tone\"\n ): \"👩🏼‍❤‍💋‍👩🏾\",\n \"kiss_woman_woman_medium-light_skin_tone_medium_skin_tone\": \"👩🏼‍❤‍💋‍👩🏽\",\n \"kiss_woman_woman_medium_skin_tone\": \"👩🏽‍❤‍💋‍👩🏽\",\n \"kiss_woman_woman_medium_skin_tone_dark_skin_tone\": \"👩🏽‍❤‍💋‍👩🏿\",\n \"kiss_woman_woman_medium_skin_tone_light_skin_tone\": \"👩🏽‍❤‍💋‍👩🏻\",\n \"kiss_woman_woman_medium_skin_tone_medium-dark_skin_tone\": \"👩🏽‍❤‍💋‍👩🏾\",\n \"kiss_woman_woman_medium_skin_tone_medium-light_skin_tone\": \"👩🏽‍❤‍💋‍👩🏼\",\n \"kissing_cat\": \"😽\",\n \"kissing_face\": \"😗\",\n \"kissing_face_with_closed_eyes\": \"😚\",\n \"kissing_face_with_smiling_eyes\": \"😙\",\n \"kitchen_knife\": \"🔪\",\n \"kite\": \"🪁\",\n \"kiwi_fruit\": \"🥝\",\n \"knot\": \"🪢\",\n \"koala\": \"🐨\",\n \"lab_coat\": \"🥼\",\n \"label\": \"🏷\",\n \"lacrosse\": \"🥍\",\n \"ladder\": \"🪜\",\n \"lady_beetle\": \"🐞\",\n \"laptop\": \"💻\",\n \"large_blue_diamond\": \"🔷\",\n \"large_orange_diamond\": \"🔶\",\n \"last_quarter_moon\": \"🌗\",\n \"last_quarter_moon_face\": \"🌜\",\n \"last_track_button\": \"⏮\",\n \"latin_cross\": \"✝\",\n \"leaf_fluttering_in_wind\": \"🍃\",\n \"leafy_green\": \"🥬\",\n \"ledger\": \"📒\",\n \"left-facing_fist\": \"🤛\",\n \"left-facing_fist_dark_skin_tone\": \"🤛🏿\",\n \"left-facing_fist_light_skin_tone\": \"🤛🏻\",\n \"left-facing_fist_medium-dark_skin_tone\": \"🤛🏾\",\n \"left-facing_fist_medium-light_skin_tone\": \"🤛🏼\",\n \"left-facing_fist_medium_skin_tone\": \"🤛🏽\",\n \"left-right_arrow\": \"↔\",\n \"left_arrow\": \"⬅\",\n \"left_arrow_curving_right\": \"↪\",\n \"left_luggage\": \"🛅\",\n \"left_speech_bubble\": \"🗨\",\n \"leftwards_hand\": \"🫲\",\n \"leftwards_hand_dark_skin_tone\": \"🫲🏿\",\n \"leftwards_hand_light_skin_tone\": \"🫲🏻\",\n \"leftwards_hand_medium-dark_skin_tone\": \"🫲🏾\",\n \"leftwards_hand_medium-light_skin_tone\": \"🫲🏼\",\n \"leftwards_hand_medium_skin_tone\": \"🫲🏽\",\n \"leftwards_pushing_hand\": \"🫷\",\n \"leftwards_pushing_hand_dark_skin_tone\": \"🫷🏿\",\n \"leftwards_pushing_hand_light_skin_tone\": \"🫷🏻\",\n \"leftwards_pushing_hand_medium-dark_skin_tone\": \"🫷🏾\",\n \"leftwards_pushing_hand_medium-light_skin_tone\": \"🫷🏼\",\n \"leftwards_pushing_hand_medium_skin_tone\": \"🫷🏽\",\n \"leg\": \"🦵\",\n \"leg_dark_skin_tone\": \"🦵🏿\",\n \"leg_light_skin_tone\": \"🦵🏻\",\n \"leg_medium-dark_skin_tone\": \"🦵🏾\",\n \"leg_medium-light_skin_tone\": \"🦵🏼\",\n \"leg_medium_skin_tone\": \"🦵🏽\",\n \"lemon\": \"🍋\",\n \"leopard\": \"🐆\",\n \"level_slider\": \"🎚\",\n \"light_blue_heart\": \"🩵\",\n \"light_bulb\": \"💡\",\n \"light_rail\": \"🚈\",\n \"light_skin_tone\": \"🏻\",\n \"link\": \"🔗\",\n \"linked_paperclips\": \"🖇\",\n \"lion\": \"🦁\",\n \"lipstick\": \"💄\",\n \"litter_in_bin_sign\": \"🚮\",\n \"lizard\": \"🦎\",\n \"llama\": \"🦙\",\n \"lobster\": \"🦞\",\n \"locked\": \"🔒\",\n \"locked_with_key\": \"🔐\",\n \"locked_with_pen\": \"🔏\",\n \"locomotive\": \"🚂\",\n \"lollipop\": \"🍭\",\n \"long_drum\": \"🪘\",\n \"lotion_bottle\": \"🧴\",\n \"lotus\": \"🪷\",\n \"loudly_crying_face\": \"😭\",\n \"loudspeaker\": \"📢\",\n \"love-you_gesture\": \"🤟\",\n \"love-you_gesture_dark_skin_tone\": \"🤟🏿\",\n \"love-you_gesture_light_skin_tone\": \"🤟🏻\",\n \"love-you_gesture_medium-dark_skin_tone\": \"🤟🏾\",\n \"love-you_gesture_medium-light_skin_tone\": \"🤟🏼\",\n \"love-you_gesture_medium_skin_tone\": \"🤟🏽\",\n \"love_hotel\": \"🏩\",\n \"love_letter\": \"💌\",\n \"low_battery\": \"🪫\",\n \"luggage\": \"🧳\",\n \"lungs\": \"🫁\",\n \"lying_face\": \"🤥\",\n \"mage\": \"🧙\",\n \"mage_dark_skin_tone\": \"🧙🏿\",\n \"mage_light_skin_tone\": \"🧙🏻\",\n \"mage_medium-dark_skin_tone\": \"🧙🏾\",\n \"mage_medium-light_skin_tone\": \"🧙🏼\",\n \"mage_medium_skin_tone\": \"🧙🏽\",\n \"magic_wand\": \"🪄\",\n \"magnet\": \"🧲\",\n \"magnifying_glass_tilted_left\": \"🔍\",\n \"magnifying_glass_tilted_right\": \"🔎\",\n \"mahjong_red_dragon\": \"🀄\",\n \"male_sign\": \"♂\",\n \"mammoth\": \"🦣\",\n \"man\": \"👨\",\n \"man_artist\": \"👨‍🎨\",\n \"man_artist_dark_skin_tone\": \"👨🏿‍🎨\",\n \"man_artist_light_skin_tone\": \"👨🏻‍🎨\",\n \"man_artist_medium-dark_skin_tone\": \"👨🏾‍🎨\",\n \"man_artist_medium-light_skin_tone\": \"👨🏼‍🎨\",\n \"man_artist_medium_skin_tone\": \"👨🏽‍🎨\",\n \"man_astronaut\": \"👨‍🚀\",\n \"man_astronaut_dark_skin_tone\": \"👨🏿‍🚀\",\n \"man_astronaut_light_skin_tone\": \"👨🏻‍🚀\",\n \"man_astronaut_medium-dark_skin_tone\": \"👨🏾‍🚀\",\n \"man_astronaut_medium-light_skin_tone\": \"👨🏼‍🚀\",\n \"man_astronaut_medium_skin_tone\": \"👨🏽‍🚀\",\n \"man_bald\": \"👨‍🦲\",\n \"man_beard\": \"🧔‍♂\",\n \"man_biking\": \"🚴‍♂\",\n \"man_biking_dark_skin_tone\": \"🚴🏿‍♂\",\n \"man_biking_light_skin_tone\": \"🚴🏻‍♂\",\n \"man_biking_medium-dark_skin_tone\": \"🚴🏾‍♂\",\n \"man_biking_medium-light_skin_tone\": \"🚴🏼‍♂\",\n \"man_biking_medium_skin_tone\": \"🚴🏽‍♂\",\n \"man_blond_hair\": \"👱‍♂\",\n \"man_bouncing_ball\": \"⛹‍♂\",\n \"man_bouncing_ball_dark_skin_tone\": \"⛹🏿‍♂\",\n \"man_bouncing_ball_light_skin_tone\": \"⛹🏻‍♂\",\n \"man_bouncing_ball_medium-dark_skin_tone\": \"⛹🏾‍♂\",\n \"man_bouncing_ball_medium-light_skin_tone\": \"⛹🏼‍♂\",\n \"man_bouncing_ball_medium_skin_tone\": \"⛹🏽‍♂\",\n \"man_bowing\": \"🙇‍♂\",\n \"man_bowing_dark_skin_tone\": \"🙇🏿‍♂\",\n \"man_bowing_light_skin_tone\": \"🙇🏻‍♂\",\n \"man_bowing_medium-dark_skin_tone\": \"🙇🏾‍♂\",\n \"man_bowing_medium-light_skin_tone\": \"🙇🏼‍♂\",\n \"man_bowing_medium_skin_tone\": \"🙇🏽‍♂\",\n \"man_cartwheeling\": \"🤸‍♂\",\n \"man_cartwheeling_dark_skin_tone\": \"🤸🏿‍♂\",\n \"man_cartwheeling_light_skin_tone\": \"🤸🏻‍♂\",\n \"man_cartwheeling_medium-dark_skin_tone\": \"🤸🏾‍♂\",\n \"man_cartwheeling_medium-light_skin_tone\": \"🤸🏼‍♂\",\n \"man_cartwheeling_medium_skin_tone\": \"🤸🏽‍♂\",\n \"man_climbing\": \"🧗‍♂\",\n \"man_climbing_dark_skin_tone\": \"🧗🏿‍♂\",\n \"man_climbing_light_skin_tone\": \"🧗🏻‍♂\",\n \"man_climbing_medium-dark_skin_tone\": \"🧗🏾‍♂\",\n \"man_climbing_medium-light_skin_tone\": \"🧗🏼‍♂\",\n \"man_climbing_medium_skin_tone\": \"🧗🏽‍♂\",\n \"man_construction_worker\": \"👷‍♂\",\n \"man_construction_worker_dark_skin_tone\": \"👷🏿‍♂\",\n \"man_construction_worker_light_skin_tone\": \"👷🏻‍♂\",\n \"man_construction_worker_medium-dark_skin_tone\": \"👷🏾‍♂\",\n \"man_construction_worker_medium-light_skin_tone\": \"👷🏼‍♂\",\n \"man_construction_worker_medium_skin_tone\": \"👷🏽‍♂\",\n \"man_cook\": \"👨‍🍳\",\n \"man_cook_dark_skin_tone\": \"👨🏿‍🍳\",\n \"man_cook_light_skin_tone\": \"👨🏻‍🍳\",\n \"man_cook_medium-dark_skin_tone\": \"👨🏾‍🍳\",\n \"man_cook_medium-light_skin_tone\": \"👨🏼‍🍳\",\n \"man_cook_medium_skin_tone\": \"👨🏽‍🍳\",\n \"man_curly_hair\": \"👨‍🦱\",\n \"man_dancing\": \"🕺\",\n \"man_dancing_dark_skin_tone\": \"🕺🏿\",\n \"man_dancing_light_skin_tone\": \"🕺🏻\",\n \"man_dancing_medium-dark_skin_tone\": \"🕺🏾\",\n \"man_dancing_medium-light_skin_tone\": \"🕺🏼\",\n \"man_dancing_medium_skin_tone\": \"🕺🏽\",\n \"man_dark_skin_tone\": \"👨🏿\",\n \"man_dark_skin_tone_bald\": \"👨🏿‍🦲\",\n \"man_dark_skin_tone_beard\": \"🧔🏿‍♂\",\n \"man_dark_skin_tone_blond_hair\": \"👱🏿‍♂\",\n \"man_dark_skin_tone_curly_hair\": \"👨🏿‍🦱\",\n \"man_dark_skin_tone_red_hair\": \"👨🏿‍🦰\",\n \"man_dark_skin_tone_white_hair\": \"👨🏿‍🦳\",\n \"man_detective\": \"🕵‍♂\",\n \"man_detective_dark_skin_tone\": \"🕵🏿‍♂\",\n \"man_detective_light_skin_tone\": \"🕵🏻‍♂\",\n \"man_detective_medium-dark_skin_tone\": \"🕵🏾‍♂\",\n \"man_detective_medium-light_skin_tone\": \"🕵🏼‍♂\",\n \"man_detective_medium_skin_tone\": \"🕵🏽‍♂\",\n \"man_elf\": \"🧝‍♂\",\n \"man_elf_dark_skin_tone\": \"🧝🏿‍♂\",\n \"man_elf_light_skin_tone\": \"🧝🏻‍♂\",\n \"man_elf_medium-dark_skin_tone\": \"🧝🏾‍♂\",\n \"man_elf_medium-light_skin_tone\": \"🧝🏼‍♂\",\n \"man_elf_medium_skin_tone\": \"🧝🏽‍♂\",\n \"man_facepalming\": \"🤦‍♂\",\n \"man_facepalming_dark_skin_tone\": \"🤦🏿‍♂\",\n \"man_facepalming_light_skin_tone\": \"🤦🏻‍♂\",\n \"man_facepalming_medium-dark_skin_tone\": \"🤦🏾‍♂\",\n \"man_facepalming_medium-light_skin_tone\": \"🤦🏼‍♂\",\n \"man_facepalming_medium_skin_tone\": \"🤦🏽‍♂\",\n \"man_factory_worker\": \"👨‍🏭\",\n \"man_factory_worker_dark_skin_tone\": \"👨🏿‍🏭\",\n \"man_factory_worker_light_skin_tone\": \"👨🏻‍🏭\",\n \"man_factory_worker_medium-dark_skin_tone\": \"👨🏾‍🏭\",\n \"man_factory_worker_medium-light_skin_tone\": \"👨🏼‍🏭\",\n \"man_factory_worker_medium_skin_tone\": \"👨🏽‍🏭\",\n \"man_fairy\": \"🧚‍♂\",\n \"man_fairy_dark_skin_tone\": \"🧚🏿‍♂\",\n \"man_fairy_light_skin_tone\": \"🧚🏻‍♂\",\n \"man_fairy_medium-dark_skin_tone\": \"🧚🏾‍♂\",\n \"man_fairy_medium-light_skin_tone\": \"🧚🏼‍♂\",\n \"man_fairy_medium_skin_tone\": \"🧚🏽‍♂\",\n \"man_farmer\": \"👨‍🌾\",\n \"man_farmer_dark_skin_tone\": \"👨🏿‍🌾\",\n \"man_farmer_light_skin_tone\": \"👨🏻‍🌾\",\n \"man_farmer_medium-dark_skin_tone\": \"👨🏾‍🌾\",\n \"man_farmer_medium-light_skin_tone\": \"👨🏼‍🌾\",\n \"man_farmer_medium_skin_tone\": \"👨🏽‍🌾\",\n \"man_feeding_baby\": \"👨‍🍼\",\n \"man_feeding_baby_dark_skin_tone\": \"👨🏿‍🍼\",\n \"man_feeding_baby_light_skin_tone\": \"👨🏻‍🍼\",\n \"man_feeding_baby_medium-dark_skin_tone\": \"👨🏾‍🍼\",\n \"man_feeding_baby_medium-light_skin_tone\": \"👨🏼‍🍼\",\n \"man_feeding_baby_medium_skin_tone\": \"👨🏽‍🍼\",\n \"man_firefighter\": \"👨‍🚒\",\n \"man_firefighter_dark_skin_tone\": \"👨🏿‍🚒\",\n \"man_firefighter_light_skin_tone\": \"👨🏻‍🚒\",\n \"man_firefighter_medium-dark_skin_tone\": \"👨🏾‍🚒\",\n \"man_firefighter_medium-light_skin_tone\": \"👨🏼‍🚒\",\n \"man_firefighter_medium_skin_tone\": \"👨🏽‍🚒\",\n \"man_frowning\": \"🙍‍♂\",\n \"man_frowning_dark_skin_tone\": \"🙍🏿‍♂\",\n \"man_frowning_light_skin_tone\": \"🙍🏻‍♂\",\n \"man_frowning_medium-dark_skin_tone\": \"🙍🏾‍♂\",\n \"man_frowning_medium-light_skin_tone\": \"🙍🏼‍♂\",\n \"man_frowning_medium_skin_tone\": \"🙍🏽‍♂\",\n \"man_genie\": \"🧞‍♂\",\n \"man_gesturing_NO\": \"🙅‍♂\",\n \"man_gesturing_NO_dark_skin_tone\": \"🙅🏿‍♂\",\n \"man_gesturing_NO_light_skin_tone\": \"🙅🏻‍♂\",\n \"man_gesturing_NO_medium-dark_skin_tone\": \"🙅🏾‍♂\",\n \"man_gesturing_NO_medium-light_skin_tone\": \"🙅🏼‍♂\",\n \"man_gesturing_NO_medium_skin_tone\": \"🙅🏽‍♂\",\n \"man_gesturing_OK\": \"🙆‍♂\",\n \"man_gesturing_OK_dark_skin_tone\": \"🙆🏿‍♂\",\n \"man_gesturing_OK_light_skin_tone\": \"🙆🏻‍♂\",\n \"man_gesturing_OK_medium-dark_skin_tone\": \"🙆🏾‍♂\",\n \"man_gesturing_OK_medium-light_skin_tone\": \"🙆🏼‍♂\",\n \"man_gesturing_OK_medium_skin_tone\": \"🙆🏽‍♂\",\n \"man_getting_haircut\": \"💇‍♂\",\n \"man_getting_haircut_dark_skin_tone\": \"💇🏿‍♂\",\n \"man_getting_haircut_light_skin_tone\": \"💇🏻‍♂\",\n \"man_getting_haircut_medium-dark_skin_tone\": \"💇🏾‍♂\",\n \"man_getting_haircut_medium-light_skin_tone\": \"💇🏼‍♂\",\n \"man_getting_haircut_medium_skin_tone\": \"💇🏽‍♂\",\n \"man_getting_massage\": \"💆‍♂\",\n \"man_getting_massage_dark_skin_tone\": \"💆🏿‍♂\",\n \"man_getting_massage_light_skin_tone\": \"💆🏻‍♂\",\n \"man_getting_massage_medium-dark_skin_tone\": \"💆🏾‍♂\",\n \"man_getting_massage_medium-light_skin_tone\": \"💆🏼‍♂\",\n \"man_getting_massage_medium_skin_tone\": \"💆🏽‍♂\",\n \"man_golfing\": \"🏌‍♂\",\n \"man_golfing_dark_skin_tone\": \"🏌🏿‍♂\",\n \"man_golfing_light_skin_tone\": \"🏌🏻‍♂\",\n \"man_golfing_medium-dark_skin_tone\": \"🏌🏾‍♂\",\n \"man_golfing_medium-light_skin_tone\": \"🏌🏼‍♂\",\n \"man_golfing_medium_skin_tone\": \"🏌🏽‍♂\",\n \"man_guard\": \"💂‍♂\",\n \"man_guard_dark_skin_tone\": \"💂🏿‍♂\",\n \"man_guard_light_skin_tone\": \"💂🏻‍♂\",\n \"man_guard_medium-dark_skin_tone\": \"💂🏾‍♂\",\n \"man_guard_medium-light_skin_tone\": \"💂🏼‍♂\",\n \"man_guard_medium_skin_tone\": \"💂🏽‍♂\",\n \"man_health_worker\": \"👨‍⚕\",\n \"man_health_worker_dark_skin_tone\": \"👨🏿‍⚕\",\n \"man_health_worker_light_skin_tone\": \"👨🏻‍⚕\",\n \"man_health_worker_medium-dark_skin_tone\": \"👨🏾‍⚕\",\n \"man_health_worker_medium-light_skin_tone\": \"👨🏼‍⚕\",\n \"man_health_worker_medium_skin_tone\": \"👨🏽‍⚕\",\n \"man_in_lotus_position\": \"🧘‍♂\",\n \"man_in_lotus_position_dark_skin_tone\": \"🧘🏿‍♂\",\n \"man_in_lotus_position_light_skin_tone\": \"🧘🏻‍♂\",\n \"man_in_lotus_position_medium-dark_skin_tone\": \"🧘🏾‍♂\",\n \"man_in_lotus_position_medium-light_skin_tone\": \"🧘🏼‍♂\",\n \"man_in_lotus_position_medium_skin_tone\": \"🧘🏽‍♂\",\n \"man_in_manual_wheelchair\": \"👨‍🦽\",\n \"man_in_manual_wheelchair_dark_skin_tone\": \"👨🏿‍🦽\",\n \"man_in_manual_wheelchair_light_skin_tone\": \"👨🏻‍🦽\",\n \"man_in_manual_wheelchair_medium-dark_skin_tone\": \"👨🏾‍🦽\",\n \"man_in_manual_wheelchair_medium-light_skin_tone\": \"👨🏼‍🦽\",\n \"man_in_manual_wheelchair_medium_skin_tone\": \"👨🏽‍🦽\",\n \"man_in_motorized_wheelchair\": \"👨‍🦼\",\n \"man_in_motorized_wheelchair_dark_skin_tone\": \"👨🏿‍🦼\",\n \"man_in_motorized_wheelchair_light_skin_tone\": \"👨🏻‍🦼\",\n \"man_in_motorized_wheelchair_medium-dark_skin_tone\": \"👨🏾‍🦼\",\n \"man_in_motorized_wheelchair_medium-light_skin_tone\": \"👨🏼‍🦼\",\n \"man_in_motorized_wheelchair_medium_skin_tone\": \"👨🏽‍🦼\",\n \"man_in_steamy_room\": \"🧖‍♂\",\n \"man_in_steamy_room_dark_skin_tone\": \"🧖🏿‍♂\",\n \"man_in_steamy_room_light_skin_tone\": \"🧖🏻‍♂\",\n \"man_in_steamy_room_medium-dark_skin_tone\": \"🧖🏾‍♂\",\n \"man_in_steamy_room_medium-light_skin_tone\": \"🧖🏼‍♂\",\n \"man_in_steamy_room_medium_skin_tone\": \"🧖🏽‍♂\",\n \"man_in_tuxedo\": \"🤵‍♂\",\n \"man_in_tuxedo_dark_skin_tone\": \"🤵🏿‍♂\",\n \"man_in_tuxedo_light_skin_tone\": \"🤵🏻‍♂\",\n \"man_in_tuxedo_medium-dark_skin_tone\": \"🤵🏾‍♂\",\n \"man_in_tuxedo_medium-light_skin_tone\": \"🤵🏼‍♂\",\n \"man_in_tuxedo_medium_skin_tone\": \"🤵🏽‍♂\",\n \"man_judge\": \"👨‍⚖\",\n \"man_judge_dark_skin_tone\": \"👨🏿‍⚖\",\n \"man_judge_light_skin_tone\": \"👨🏻‍⚖\",\n \"man_judge_medium-dark_skin_tone\": \"👨🏾‍⚖\",\n \"man_judge_medium-light_skin_tone\": \"👨🏼‍⚖\",\n \"man_judge_medium_skin_tone\": \"👨🏽‍⚖\",\n \"man_juggling\": \"🤹‍♂\",\n \"man_juggling_dark_skin_tone\": \"🤹🏿‍♂\",\n \"man_juggling_light_skin_tone\": \"🤹🏻‍♂\",\n \"man_juggling_medium-dark_skin_tone\": \"🤹🏾‍♂\",\n \"man_juggling_medium-light_skin_tone\": \"🤹🏼‍♂\",\n \"man_juggling_medium_skin_tone\": \"🤹🏽‍♂\",\n \"man_kneeling\": \"🧎‍♂\",\n \"man_kneeling_dark_skin_tone\": \"🧎🏿‍♂\",\n \"man_kneeling_light_skin_tone\": \"🧎🏻‍♂\",\n \"man_kneeling_medium-dark_skin_tone\": \"🧎🏾‍♂\",\n \"man_kneeling_medium-light_skin_tone\": \"🧎🏼‍♂\",\n \"man_kneeling_medium_skin_tone\": \"🧎🏽‍♂\",\n \"man_lifting_weights\": \"🏋‍♂\",\n \"man_lifting_weights_dark_skin_tone\": \"🏋🏿‍♂\",\n \"man_lifting_weights_light_skin_tone\": \"🏋🏻‍♂\",\n \"man_lifting_weights_medium-dark_skin_tone\": \"🏋🏾‍♂\",\n \"man_lifting_weights_medium-light_skin_tone\": \"🏋🏼‍♂\",\n \"man_lifting_weights_medium_skin_tone\": \"🏋🏽‍♂\",\n \"man_light_skin_tone\": \"👨🏻\",\n \"man_light_skin_tone_bald\": \"👨🏻‍🦲\",\n \"man_light_skin_tone_beard\": \"🧔🏻‍♂\",\n \"man_light_skin_tone_blond_hair\": \"👱🏻‍♂\",\n \"man_light_skin_tone_curly_hair\": \"👨🏻‍🦱\",\n \"man_light_skin_tone_red_hair\": \"👨🏻‍🦰\",\n \"man_light_skin_tone_white_hair\": \"👨🏻‍🦳\",\n \"man_mage\": \"🧙‍♂\",\n \"man_mage_dark_skin_tone\": \"🧙🏿‍♂\",\n \"man_mage_light_skin_tone\": \"🧙🏻‍♂\",\n \"man_mage_medium-dark_skin_tone\": \"🧙🏾‍♂\",\n \"man_mage_medium-light_skin_tone\": \"🧙🏼‍♂\",\n \"man_mage_medium_skin_tone\": \"🧙🏽‍♂\",\n \"man_mechanic\": \"👨‍🔧\",\n \"man_mechanic_dark_skin_tone\": \"👨🏿‍🔧\",\n \"man_mechanic_light_skin_tone\": \"👨🏻‍🔧\",\n \"man_mechanic_medium-dark_skin_tone\": \"👨🏾‍🔧\",\n \"man_mechanic_medium-light_skin_tone\": \"👨🏼‍🔧\",\n \"man_mechanic_medium_skin_tone\": \"👨🏽‍🔧\",\n \"man_medium-dark_skin_tone\": \"👨🏾\",\n \"man_medium-dark_skin_tone_bald\": \"👨🏾‍🦲\",\n \"man_medium-dark_skin_tone_beard\": \"🧔🏾‍♂\",\n \"man_medium-dark_skin_tone_blond_hair\": \"👱🏾‍♂\",\n \"man_medium-dark_skin_tone_curly_hair\": \"👨🏾‍🦱\",\n \"man_medium-dark_skin_tone_red_hair\": \"👨🏾‍🦰\",\n \"man_medium-dark_skin_tone_white_hair\": \"👨🏾‍🦳\",\n \"man_medium-light_skin_tone\": \"👨🏼\",\n \"man_medium-light_skin_tone_bald\": \"👨🏼‍🦲\",\n \"man_medium-light_skin_tone_beard\": \"🧔🏼‍♂\",\n \"man_medium-light_skin_tone_blond_hair\": \"👱🏼‍♂\",\n \"man_medium-light_skin_tone_curly_hair\": \"👨🏼‍🦱\",\n \"man_medium-light_skin_tone_red_hair\": \"👨🏼‍🦰\",\n \"man_medium-light_skin_tone_white_hair\": \"👨🏼‍🦳\",\n \"man_medium_skin_tone\": \"👨🏽\",\n \"man_medium_skin_tone_bald\": \"👨🏽‍🦲\",\n \"man_medium_skin_tone_beard\": \"🧔🏽‍♂\",\n \"man_medium_skin_tone_blond_hair\": \"👱🏽‍♂\",\n \"man_medium_skin_tone_curly_hair\": \"👨🏽‍🦱\",\n \"man_medium_skin_tone_red_hair\": \"👨🏽‍🦰\",\n \"man_medium_skin_tone_white_hair\": \"👨🏽‍🦳\",\n \"man_mountain_biking\": \"🚵‍♂\",\n \"man_mountain_biking_dark_skin_tone\": \"🚵🏿‍♂\",\n \"man_mountain_biking_light_skin_tone\": \"🚵🏻‍♂\",\n \"man_mountain_biking_medium-dark_skin_tone\": \"🚵🏾‍♂\",\n \"man_mountain_biking_medium-light_skin_tone\": \"🚵🏼‍♂\",\n \"man_mountain_biking_medium_skin_tone\": \"🚵🏽‍♂\",\n \"man_office_worker\": \"👨‍💼\",\n \"man_office_worker_dark_skin_tone\": \"👨🏿‍💼\",\n \"man_office_worker_light_skin_tone\": \"👨🏻‍💼\",\n \"man_office_worker_medium-dark_skin_tone\": \"👨🏾‍💼\",\n \"man_office_worker_medium-light_skin_tone\": \"👨🏼‍💼\",\n \"man_office_worker_medium_skin_tone\": \"👨🏽‍💼\",\n \"man_pilot\": \"👨‍✈\",\n \"man_pilot_dark_skin_tone\": \"👨🏿‍✈\",\n \"man_pilot_light_skin_tone\": \"👨🏻‍✈\",\n \"man_pilot_medium-dark_skin_tone\": \"👨🏾‍✈\",\n \"man_pilot_medium-light_skin_tone\": \"👨🏼‍✈\",\n \"man_pilot_medium_skin_tone\": \"👨🏽‍✈\",\n \"man_playing_handball\": \"🤾‍♂\",\n \"man_playing_handball_dark_skin_tone\": \"🤾🏿‍♂\",\n \"man_playing_handball_light_skin_tone\": \"🤾🏻‍♂\",\n \"man_playing_handball_medium-dark_skin_tone\": \"🤾🏾‍♂\",\n \"man_playing_handball_medium-light_skin_tone\": \"🤾🏼‍♂\",\n \"man_playing_handball_medium_skin_tone\": \"🤾🏽‍♂\",\n \"man_playing_water_polo\": \"🤽‍♂\",\n \"man_playing_water_polo_dark_skin_tone\": \"🤽🏿‍♂\",\n \"man_playing_water_polo_light_skin_tone\": \"🤽🏻‍♂\",\n \"man_playing_water_polo_medium-dark_skin_tone\": \"🤽🏾‍♂\",\n \"man_playing_water_polo_medium-light_skin_tone\": \"🤽🏼‍♂\",\n \"man_playing_water_polo_medium_skin_tone\": \"🤽🏽‍♂\",\n \"man_police_officer\": \"👮‍♂\",\n \"man_police_officer_dark_skin_tone\": \"👮🏿‍♂\",\n \"man_police_officer_light_skin_tone\": \"👮🏻‍♂\",\n \"man_police_officer_medium-dark_skin_tone\": \"👮🏾‍♂\",\n \"man_police_officer_medium-light_skin_tone\": \"👮🏼‍♂\",\n \"man_police_officer_medium_skin_tone\": \"👮🏽‍♂\",\n \"man_pouting\": \"🙎‍♂\",\n \"man_pouting_dark_skin_tone\": \"🙎🏿‍♂\",\n \"man_pouting_light_skin_tone\": \"🙎🏻‍♂\",\n \"man_pouting_medium-dark_skin_tone\": \"🙎🏾‍♂\",\n \"man_pouting_medium-light_skin_tone\": \"🙎🏼‍♂\",\n \"man_pouting_medium_skin_tone\": \"🙎🏽‍♂\",\n \"man_raising_hand\": \"🙋‍♂\",\n \"man_raising_hand_dark_skin_tone\": \"🙋🏿‍♂\",\n \"man_raising_hand_light_skin_tone\": \"🙋🏻‍♂\",\n \"man_raising_hand_medium-dark_skin_tone\": \"🙋🏾‍♂\",\n \"man_raising_hand_medium-light_skin_tone\": \"🙋🏼‍♂\",\n \"man_raising_hand_medium_skin_tone\": \"🙋🏽‍♂\",\n \"man_red_hair\": \"👨‍🦰\",\n \"man_rowing_boat\": \"🚣‍♂\",\n \"man_rowing_boat_dark_skin_tone\": \"🚣🏿‍♂\",\n \"man_rowing_boat_light_skin_tone\": \"🚣🏻‍♂\",\n \"man_rowing_boat_medium-dark_skin_tone\": \"🚣🏾‍♂\",\n \"man_rowing_boat_medium-light_skin_tone\": \"🚣🏼‍♂\",\n \"man_rowing_boat_medium_skin_tone\": \"🚣🏽‍♂\",\n \"man_running\": \"🏃‍♂\",\n \"man_running_dark_skin_tone\": \"🏃🏿‍♂\",\n \"man_running_light_skin_tone\": \"🏃🏻‍♂\",\n \"man_running_medium-dark_skin_tone\": \"🏃🏾‍♂\",\n \"man_running_medium-light_skin_tone\": \"🏃🏼‍♂\",\n \"man_running_medium_skin_tone\": \"🏃🏽‍♂\",\n \"man_scientist\": \"👨‍🔬\",\n \"man_scientist_dark_skin_tone\": \"👨🏿‍🔬\",\n \"man_scientist_light_skin_tone\": \"👨🏻‍🔬\",\n \"man_scientist_medium-dark_skin_tone\": \"👨🏾‍🔬\",\n \"man_scientist_medium-light_skin_tone\": \"👨🏼‍🔬\",\n \"man_scientist_medium_skin_tone\": \"👨🏽‍🔬\",\n \"man_shrugging\": \"🤷‍♂\",\n \"man_shrugging_dark_skin_tone\": \"🤷🏿‍♂\",\n \"man_shrugging_light_skin_tone\": \"🤷🏻‍♂\",\n \"man_shrugging_medium-dark_skin_tone\": \"🤷🏾‍♂\",\n \"man_shrugging_medium-light_skin_tone\": \"🤷🏼‍♂\",\n \"man_shrugging_medium_skin_tone\": \"🤷🏽‍♂\",\n \"man_singer\": \"👨‍🎤\",\n \"man_singer_dark_skin_tone\": \"👨🏿‍🎤\",\n \"man_singer_light_skin_tone\": \"👨🏻‍🎤\",\n \"man_singer_medium-dark_skin_tone\": \"👨🏾‍🎤\",\n \"man_singer_medium-light_skin_tone\": \"👨🏼‍🎤\",\n \"man_singer_medium_skin_tone\": \"👨🏽‍🎤\",\n \"man_standing\": \"🧍‍♂\",\n \"man_standing_dark_skin_tone\": \"🧍🏿‍♂\",\n \"man_standing_light_skin_tone\": \"🧍🏻‍♂\",\n \"man_standing_medium-dark_skin_tone\": \"🧍🏾‍♂\",\n \"man_standing_medium-light_skin_tone\": \"🧍🏼‍♂\",\n \"man_standing_medium_skin_tone\": \"🧍🏽‍♂\",\n \"man_student\": \"👨‍🎓\",\n \"man_student_dark_skin_tone\": \"👨🏿‍🎓\",\n \"man_student_light_skin_tone\": \"👨🏻‍🎓\",\n \"man_student_medium-dark_skin_tone\": \"👨🏾‍🎓\",\n \"man_student_medium-light_skin_tone\": \"👨🏼‍🎓\",\n \"man_student_medium_skin_tone\": \"👨🏽‍🎓\",\n \"man_superhero\": \"🦸‍♂\",\n \"man_superhero_dark_skin_tone\": \"🦸🏿‍♂\",\n \"man_superhero_light_skin_tone\": \"🦸🏻‍♂\",\n \"man_superhero_medium-dark_skin_tone\": \"🦸🏾‍♂\",\n \"man_superhero_medium-light_skin_tone\": \"🦸🏼‍♂\",\n \"man_superhero_medium_skin_tone\": \"🦸🏽‍♂\",\n \"man_supervillain\": \"🦹‍♂\",\n \"man_supervillain_dark_skin_tone\": \"🦹🏿‍♂\",\n \"man_supervillain_light_skin_tone\": \"🦹🏻‍♂\",\n \"man_supervillain_medium-dark_skin_tone\": \"🦹🏾‍♂\",\n \"man_supervillain_medium-light_skin_tone\": \"🦹🏼‍♂\",\n \"man_supervillain_medium_skin_tone\": \"🦹🏽‍♂\",\n \"man_surfing\": \"🏄‍♂\",\n \"man_surfing_dark_skin_tone\": \"🏄🏿‍♂\",\n \"man_surfing_light_skin_tone\": \"🏄🏻‍♂\",\n \"man_surfing_medium-dark_skin_tone\": \"🏄🏾‍♂\",\n \"man_surfing_medium-light_skin_tone\": \"🏄🏼‍♂\",\n \"man_surfing_medium_skin_tone\": \"🏄🏽‍♂\",\n \"man_swimming\": \"🏊‍♂\",\n \"man_swimming_dark_skin_tone\": \"🏊🏿‍♂\",\n \"man_swimming_light_skin_tone\": \"🏊🏻‍♂\",\n \"man_swimming_medium-dark_skin_tone\": \"🏊🏾‍♂\",\n \"man_swimming_medium-light_skin_tone\": \"🏊🏼‍♂\",\n \"man_swimming_medium_skin_tone\": \"🏊🏽‍♂\",\n \"man_teacher\": \"👨‍🏫\",\n \"man_teacher_dark_skin_tone\": \"👨🏿‍🏫\",\n \"man_teacher_light_skin_tone\": \"👨🏻‍🏫\",\n \"man_teacher_medium-dark_skin_tone\": \"👨🏾‍🏫\",\n \"man_teacher_medium-light_skin_tone\": \"👨🏼‍🏫\",\n \"man_teacher_medium_skin_tone\": \"👨🏽‍🏫\",\n \"man_technologist\": \"👨‍💻\",\n \"man_technologist_dark_skin_tone\": \"👨🏿‍💻\",\n \"man_technologist_light_skin_tone\": \"👨🏻‍💻\",\n \"man_technologist_medium-dark_skin_tone\": \"👨🏾‍💻\",\n \"man_technologist_medium-light_skin_tone\": \"👨🏼‍💻\",\n \"man_technologist_medium_skin_tone\": \"👨🏽‍💻\",\n \"man_tipping_hand\": \"💁‍♂\",\n \"man_tipping_hand_dark_skin_tone\": \"💁🏿‍♂\",\n \"man_tipping_hand_light_skin_tone\": \"💁🏻‍♂\",\n \"man_tipping_hand_medium-dark_skin_tone\": \"💁🏾‍♂\",\n \"man_tipping_hand_medium-light_skin_tone\": \"💁🏼‍♂\",\n \"man_tipping_hand_medium_skin_tone\": \"💁🏽‍♂\",\n \"man_vampire\": \"🧛‍♂\",\n \"man_vampire_dark_skin_tone\": \"🧛🏿‍♂\",\n \"man_vampire_light_skin_tone\": \"🧛🏻‍♂\",\n \"man_vampire_medium-dark_skin_tone\": \"🧛🏾‍♂\",\n \"man_vampire_medium-light_skin_tone\": \"🧛🏼‍♂\",\n \"man_vampire_medium_skin_tone\": \"🧛🏽‍♂\",\n \"man_walking\": \"🚶‍♂\",\n \"man_walking_dark_skin_tone\": \"🚶🏿‍♂\",\n \"man_walking_light_skin_tone\": \"🚶🏻‍♂\",\n \"man_walking_medium-dark_skin_tone\": \"🚶🏾‍♂\",\n \"man_walking_medium-light_skin_tone\": \"🚶🏼‍♂\",\n \"man_walking_medium_skin_tone\": \"🚶🏽‍♂\",\n \"man_wearing_turban\": \"👳‍♂\",\n \"man_wearing_turban_dark_skin_tone\": \"👳🏿‍♂\",\n \"man_wearing_turban_light_skin_tone\": \"👳🏻‍♂\",\n \"man_wearing_turban_medium-dark_skin_tone\": \"👳🏾‍♂\",\n \"man_wearing_turban_medium-light_skin_tone\": \"👳🏼‍♂\",\n \"man_wearing_turban_medium_skin_tone\": \"👳🏽‍♂\",\n \"man_white_hair\": \"👨‍🦳\",\n \"man_with_veil\": \"👰‍♂\",\n \"man_with_veil_dark_skin_tone\": \"👰🏿‍♂\",\n \"man_with_veil_light_skin_tone\": \"👰🏻‍♂\",\n \"man_with_veil_medium-dark_skin_tone\": \"👰🏾‍♂\",\n \"man_with_veil_medium-light_skin_tone\": \"👰🏼‍♂\",\n \"man_with_veil_medium_skin_tone\": \"👰🏽‍♂\",\n \"man_with_white_cane\": \"👨‍🦯\",\n \"man_with_white_cane_dark_skin_tone\": \"👨🏿‍🦯\",\n \"man_with_white_cane_light_skin_tone\": \"👨🏻‍🦯\",\n \"man_with_white_cane_medium-dark_skin_tone\": \"👨🏾‍🦯\",\n \"man_with_white_cane_medium-light_skin_tone\": \"👨🏼‍🦯\",\n \"man_with_white_cane_medium_skin_tone\": \"👨🏽‍🦯\",\n \"man_zombie\": \"🧟‍♂\",\n \"mango\": \"🥭\",\n \"mantelpiece_clock\": \"🕰\",\n \"manual_wheelchair\": \"🦽\",\n \"man’s_shoe\": \"👞\",\n \"map_of_Japan\": \"🗾\",\n \"maple_leaf\": \"🍁\",\n \"maracas\": \"🪇\",\n \"martial_arts_uniform\": \"🥋\",\n \"mate\": \"🧉\",\n \"meat_on_bone\": \"🍖\",\n \"mechanic\": \"🧑‍🔧\",\n \"mechanic_dark_skin_tone\": \"🧑🏿‍🔧\",\n \"mechanic_light_skin_tone\": \"🧑🏻‍🔧\",\n \"mechanic_medium-dark_skin_tone\": \"🧑🏾‍🔧\",\n \"mechanic_medium-light_skin_tone\": \"🧑🏼‍🔧\",\n \"mechanic_medium_skin_tone\": \"🧑🏽‍🔧\",\n \"mechanical_arm\": \"🦾\",\n \"mechanical_leg\": \"🦿\",\n \"medical_symbol\": \"⚕\",\n \"medium-dark_skin_tone\": \"🏾\",\n \"medium-light_skin_tone\": \"🏼\",\n \"medium_skin_tone\": \"🏽\",\n \"megaphone\": \"📣\",\n \"melon\": \"🍈\",\n \"melting_face\": \"🫠\",\n \"memo\": \"📝\",\n \"men_holding_hands\": \"👬\",\n \"men_holding_hands_dark_skin_tone\": \"👬🏿\",\n \"men_holding_hands_dark_skin_tone_light_skin_tone\": \"👨🏿‍🤝‍👨🏻\",\n \"men_holding_hands_dark_skin_tone_medium-dark_skin_tone\": \"👨🏿‍🤝‍👨🏾\",\n \"men_holding_hands_dark_skin_tone_medium-light_skin_tone\": \"👨🏿‍🤝‍👨🏼\",\n \"men_holding_hands_dark_skin_tone_medium_skin_tone\": \"👨🏿‍🤝‍👨🏽\",\n \"men_holding_hands_light_skin_tone\": \"👬🏻\",\n \"men_holding_hands_light_skin_tone_dark_skin_tone\": \"👨🏻‍🤝‍👨🏿\",\n \"men_holding_hands_light_skin_tone_medium-dark_skin_tone\": \"👨🏻‍🤝‍👨🏾\",\n \"men_holding_hands_light_skin_tone_medium-light_skin_tone\": \"👨🏻‍🤝‍👨🏼\",\n \"men_holding_hands_light_skin_tone_medium_skin_tone\": \"👨🏻‍🤝‍👨🏽\",\n \"men_holding_hands_medium-dark_skin_tone\": \"👬🏾\",\n \"men_holding_hands_medium-dark_skin_tone_dark_skin_tone\": \"👨🏾‍🤝‍👨🏿\",\n \"men_holding_hands_medium-dark_skin_tone_light_skin_tone\": \"👨🏾‍🤝‍👨🏻\",\n (\n \"men_holding_hands_medium-dark_skin_tone_medium-light_skin_tone\"\n ): \"👨🏾‍🤝‍👨🏼\",\n \"men_holding_hands_medium-dark_skin_tone_medium_skin_tone\": \"👨🏾‍🤝‍👨🏽\",\n \"men_holding_hands_medium-light_skin_tone\": \"👬🏼\",\n \"men_holding_hands_medium-light_skin_tone_dark_skin_tone\": \"👨🏼‍🤝‍👨🏿\",\n \"men_holding_hands_medium-light_skin_tone_light_skin_tone\": \"👨🏼‍🤝‍👨🏻\",\n (\n \"men_holding_hands_medium-light_skin_tone_medium-dark_skin_tone\"\n ): \"👨🏼‍🤝‍👨🏾\",\n \"men_holding_hands_medium-light_skin_tone_medium_skin_tone\": \"👨🏼‍🤝‍👨🏽\",\n \"men_holding_hands_medium_skin_tone\": \"👬🏽\",\n \"men_holding_hands_medium_skin_tone_dark_skin_tone\": \"👨🏽‍🤝‍👨🏿\",\n \"men_holding_hands_medium_skin_tone_light_skin_tone\": \"👨🏽‍🤝‍👨🏻\",\n \"men_holding_hands_medium_skin_tone_medium-dark_skin_tone\": \"👨🏽‍🤝‍👨🏾\",\n \"men_holding_hands_medium_skin_tone_medium-light_skin_tone\": \"👨🏽‍🤝‍👨🏼\",\n \"men_with_bunny_ears\": \"👯‍♂\",\n \"men_wrestling\": \"🤼‍♂\",\n \"mending_heart\": \"❤‍🩹\",\n \"menorah\": \"🕎\",\n \"men’s_room\": \"🚹\",\n \"mermaid\": \"🧜‍♀\",\n \"mermaid_dark_skin_tone\": \"🧜🏿‍♀\",\n \"mermaid_light_skin_tone\": \"🧜🏻‍♀\",\n \"mermaid_medium-dark_skin_tone\": \"🧜🏾‍♀\",\n \"mermaid_medium-light_skin_tone\": \"🧜🏼‍♀\",\n \"mermaid_medium_skin_tone\": \"🧜🏽‍♀\",\n \"merman\": \"🧜‍♂\",\n \"merman_dark_skin_tone\": \"🧜🏿‍♂\",\n \"merman_light_skin_tone\": \"🧜🏻‍♂\",\n \"merman_medium-dark_skin_tone\": \"🧜🏾‍♂\",\n \"merman_medium-light_skin_tone\": \"🧜🏼‍♂\",\n \"merman_medium_skin_tone\": \"🧜🏽‍♂\",\n \"merperson\": \"🧜\",\n \"merperson_dark_skin_tone\": \"🧜🏿\",\n \"merperson_light_skin_tone\": \"🧜🏻\",\n \"merperson_medium-dark_skin_tone\": \"🧜🏾\",\n \"merperson_medium-light_skin_tone\": \"🧜🏼\",\n \"merperson_medium_skin_tone\": \"🧜🏽\",\n \"metro\": \"🚇\",\n \"microbe\": \"🦠\",\n \"microphone\": \"🎤\",\n \"microscope\": \"🔬\",\n \"middle_finger\": \"🖕\",\n \"middle_finger_dark_skin_tone\": \"🖕🏿\",\n \"middle_finger_light_skin_tone\": \"🖕🏻\",\n \"middle_finger_medium-dark_skin_tone\": \"🖕🏾\",\n \"middle_finger_medium-light_skin_tone\": \"🖕🏼\",\n \"middle_finger_medium_skin_tone\": \"🖕🏽\",\n \"military_helmet\": \"🪖\",\n \"military_medal\": \"🎖\",\n \"milky_way\": \"🌌\",\n \"minibus\": \"🚐\",\n \"minus\": \"➖\",\n \"mirror\": \"🪞\",\n \"mirror_ball\": \"🪩\",\n \"moai\": \"🗿\",\n \"mobile_phone\": \"📱\",\n \"mobile_phone_off\": \"📴\",\n \"mobile_phone_with_arrow\": \"📲\",\n \"money-mouth_face\": \"🤑\",\n \"money_bag\": \"💰\",\n \"money_with_wings\": \"💸\",\n \"monkey\": \"🐒\",\n \"monkey_face\": \"🐵\",\n \"monorail\": \"🚝\",\n \"moon_cake\": \"🥮\",\n \"moon_viewing_ceremony\": \"🎑\",\n \"moose\": \"🫎\",\n \"mosque\": \"🕌\",\n \"mosquito\": \"🦟\",\n \"motor_boat\": \"🛥\",\n \"motor_scooter\": \"🛵\",\n \"motorcycle\": \"🏍\",\n \"motorized_wheelchair\": \"🦼\",\n \"motorway\": \"🛣\",\n \"mount_fuji\": \"🗻\",\n \"mountain\": \"⛰\",\n \"mountain_cableway\": \"🚠\",\n \"mountain_railway\": \"🚞\",\n \"mouse\": \"🐁\",\n \"mouse_face\": \"🐭\",\n \"mouse_trap\": \"🪤\",\n \"mouth\": \"👄\",\n \"movie_camera\": \"🎥\",\n \"multiply\": \"✖\",\n \"mushroom\": \"🍄\",\n \"musical_keyboard\": \"🎹\",\n \"musical_note\": \"🎵\",\n \"musical_notes\": \"🎶\",\n \"musical_score\": \"🎼\",\n \"muted_speaker\": \"🔇\",\n \"mx_claus\": \"🧑‍🎄\",\n \"mx_claus_dark_skin_tone\": \"🧑🏿‍🎄\",\n \"mx_claus_light_skin_tone\": \"🧑🏻‍🎄\",\n \"mx_claus_medium-dark_skin_tone\": \"🧑🏾‍🎄\",\n \"mx_claus_medium-light_skin_tone\": \"🧑🏼‍🎄\",\n \"mx_claus_medium_skin_tone\": \"🧑🏽‍🎄\",\n \"nail_polish\": \"💅\",\n \"nail_polish_dark_skin_tone\": \"💅🏿\",\n \"nail_polish_light_skin_tone\": \"💅🏻\",\n \"nail_polish_medium-dark_skin_tone\": \"💅🏾\",\n \"nail_polish_medium-light_skin_tone\": \"💅🏼\",\n \"nail_polish_medium_skin_tone\": \"💅🏽\",\n \"name_badge\": \"📛\",\n \"national_park\": \"🏞\",\n \"nauseated_face\": \"🤢\",\n \"nazar_amulet\": \"🧿\",\n \"necktie\": \"👔\",\n \"nerd_face\": \"🤓\",\n \"nest_with_eggs\": \"🪺\",\n \"nesting_dolls\": \"🪆\",\n \"neutral_face\": \"😐\",\n \"new_moon\": \"🌑\",\n \"new_moon_face\": \"🌚\",\n \"newspaper\": \"📰\",\n \"next_track_button\": \"⏭\",\n \"night_with_stars\": \"🌃\",\n \"nine-thirty\": \"🕤\",\n \"nine_o’clock\": \"🕘\",\n \"ninja\": \"🥷\",\n \"ninja_dark_skin_tone\": \"🥷🏿\",\n \"ninja_light_skin_tone\": \"🥷🏻\",\n \"ninja_medium-dark_skin_tone\": \"🥷🏾\",\n \"ninja_medium-light_skin_tone\": \"🥷🏼\",\n \"ninja_medium_skin_tone\": \"🥷🏽\",\n \"no_bicycles\": \"🚳\",\n \"no_entry\": \"⛔\",\n \"no_littering\": \"🚯\",\n \"no_mobile_phones\": \"📵\",\n \"no_one_under_eighteen\": \"🔞\",\n \"no_pedestrians\": \"🚷\",\n \"no_smoking\": \"🚭\",\n \"non-potable_water\": \"🚱\",\n \"nose\": \"👃\",\n \"nose_dark_skin_tone\": \"👃🏿\",\n \"nose_light_skin_tone\": \"👃🏻\",\n \"nose_medium-dark_skin_tone\": \"👃🏾\",\n \"nose_medium-light_skin_tone\": \"👃🏼\",\n \"nose_medium_skin_tone\": \"👃🏽\",\n \"notebook\": \"📓\",\n \"notebook_with_decorative_cover\": \"📔\",\n \"nut_and_bolt\": \"🔩\",\n \"octopus\": \"🐙\",\n \"oden\": \"🍢\",\n \"office_building\": \"🏢\",\n \"office_worker\": \"🧑‍💼\",\n \"office_worker_dark_skin_tone\": \"🧑🏿‍💼\",\n \"office_worker_light_skin_tone\": \"🧑🏻‍💼\",\n \"office_worker_medium-dark_skin_tone\": \"🧑🏾‍💼\",\n \"office_worker_medium-light_skin_tone\": \"🧑🏼‍💼\",\n \"office_worker_medium_skin_tone\": \"🧑🏽‍💼\",\n \"ogre\": \"👹\",\n \"oil_drum\": \"🛢\",\n \"old_key\": \"🗝\",\n \"old_man\": \"👴\",\n \"old_man_dark_skin_tone\": \"👴🏿\",\n \"old_man_light_skin_tone\": \"👴🏻\",\n \"old_man_medium-dark_skin_tone\": \"👴🏾\",\n \"old_man_medium-light_skin_tone\": \"👴🏼\",\n \"old_man_medium_skin_tone\": \"👴🏽\",\n \"old_woman\": \"👵\",\n \"old_woman_dark_skin_tone\": \"👵🏿\",\n \"old_woman_light_skin_tone\": \"👵🏻\",\n \"old_woman_medium-dark_skin_tone\": \"👵🏾\",\n \"old_woman_medium-light_skin_tone\": \"👵🏼\",\n \"old_woman_medium_skin_tone\": \"👵🏽\",\n \"older_person\": \"🧓\",\n \"older_person_dark_skin_tone\": \"🧓🏿\",\n \"older_person_light_skin_tone\": \"🧓🏻\",\n \"older_person_medium-dark_skin_tone\": \"🧓🏾\",\n \"older_person_medium-light_skin_tone\": \"🧓🏼\",\n \"older_person_medium_skin_tone\": \"🧓🏽\",\n \"olive\": \"🫒\",\n \"om\": \"🕉\",\n \"oncoming_automobile\": \"🚘\",\n \"oncoming_bus\": \"🚍\",\n \"oncoming_fist\": \"👊\",\n \"oncoming_fist_dark_skin_tone\": \"👊🏿\",\n \"oncoming_fist_light_skin_tone\": \"👊🏻\",\n \"oncoming_fist_medium-dark_skin_tone\": \"👊🏾\",\n \"oncoming_fist_medium-light_skin_tone\": \"👊🏼\",\n \"oncoming_fist_medium_skin_tone\": \"👊🏽\",\n \"oncoming_police_car\": \"🚔\",\n \"oncoming_taxi\": \"🚖\",\n \"one-piece_swimsuit\": \"🩱\",\n \"one-thirty\": \"🕜\",\n \"one_o’clock\": \"🕐\",\n \"onion\": \"🧅\",\n \"open_book\": \"📖\",\n \"open_file_folder\": \"📂\",\n \"open_hands\": \"👐\",\n \"open_hands_dark_skin_tone\": \"👐🏿\",\n \"open_hands_light_skin_tone\": \"👐🏻\",\n \"open_hands_medium-dark_skin_tone\": \"👐🏾\",\n \"open_hands_medium-light_skin_tone\": \"👐🏼\",\n \"open_hands_medium_skin_tone\": \"👐🏽\",\n \"open_mailbox_with_lowered_flag\": \"📭\",\n \"open_mailbox_with_raised_flag\": \"📬\",\n \"optical_disk\": \"💿\",\n \"orange_book\": \"📙\",\n \"orange_circle\": \"🟠\",\n \"orange_heart\": \"🧡\",\n \"orange_square\": \"🟧\",\n \"orangutan\": \"🦧\",\n \"orthodox_cross\": \"☦\",\n \"otter\": \"🦦\",\n \"outbox_tray\": \"📤\",\n \"owl\": \"🦉\",\n \"ox\": \"🐂\",\n \"oyster\": \"🦪\",\n \"package\": \"📦\",\n \"page_facing_up\": \"📄\",\n \"page_with_curl\": \"📃\",\n \"pager\": \"📟\",\n \"paintbrush\": \"🖌\",\n \"palm_down_hand\": \"🫳\",\n \"palm_down_hand_dark_skin_tone\": \"🫳🏿\",\n \"palm_down_hand_light_skin_tone\": \"🫳🏻\",\n \"palm_down_hand_medium-dark_skin_tone\": \"🫳🏾\",\n \"palm_down_hand_medium-light_skin_tone\": \"🫳🏼\",\n \"palm_down_hand_medium_skin_tone\": \"🫳🏽\",\n \"palm_tree\": \"🌴\",\n \"palm_up_hand\": \"🫴\",\n \"palm_up_hand_dark_skin_tone\": \"🫴🏿\",\n \"palm_up_hand_light_skin_tone\": \"🫴🏻\",\n \"palm_up_hand_medium-dark_skin_tone\": \"🫴🏾\",\n \"palm_up_hand_medium-light_skin_tone\": \"🫴🏼\",\n \"palm_up_hand_medium_skin_tone\": \"🫴🏽\",\n \"palms_up_together\": \"🤲\",\n \"palms_up_together_dark_skin_tone\": \"🤲🏿\",\n \"palms_up_together_light_skin_tone\": \"🤲🏻\",\n \"palms_up_together_medium-dark_skin_tone\": \"🤲🏾\",\n \"palms_up_together_medium-light_skin_tone\": \"🤲🏼\",\n \"palms_up_together_medium_skin_tone\": \"🤲🏽\",\n \"pancakes\": \"🥞\",\n \"panda\": \"🐼\",\n \"paperclip\": \"📎\",\n \"parachute\": \"🪂\",\n \"parrot\": \"🦜\",\n \"part_alternation_mark\": \"〽\",\n \"party_popper\": \"🎉\",\n \"partying_face\": \"🥳\",\n \"passenger_ship\": \"🛳\",\n \"passport_control\": \"🛂\",\n \"pause_button\": \"⏸\",\n \"paw_prints\": \"🐾\",\n \"pea_pod\": \"🫛\",\n \"peace_symbol\": \"☮\",\n \"peach\": \"🍑\",\n \"peacock\": \"🦚\",\n \"peanuts\": \"🥜\",\n \"pear\": \"🍐\",\n \"pen\": \"🖊\",\n \"pencil\": \"✏\",\n \"penguin\": \"🐧\",\n \"pensive_face\": \"😔\",\n \"people_holding_hands\": \"🧑‍🤝‍🧑\",\n \"people_holding_hands_dark_skin_tone\": \"🧑🏿‍🤝‍🧑🏿\",\n \"people_holding_hands_dark_skin_tone_light_skin_tone\": \"🧑🏿‍🤝‍🧑🏻\",\n \"people_holding_hands_dark_skin_tone_medium-dark_skin_tone\": \"🧑🏿‍🤝‍🧑🏾\",\n \"people_holding_hands_dark_skin_tone_medium-light_skin_tone\": \"🧑🏿‍🤝‍🧑🏼\",\n \"people_holding_hands_dark_skin_tone_medium_skin_tone\": \"🧑🏿‍🤝‍🧑🏽\",\n \"people_holding_hands_light_skin_tone\": \"🧑🏻‍🤝‍🧑🏻\",\n \"people_holding_hands_light_skin_tone_dark_skin_tone\": \"🧑🏻‍🤝‍🧑🏿\",\n \"people_holding_hands_light_skin_tone_medium-dark_skin_tone\": \"🧑🏻‍🤝‍🧑🏾\",\n (\n \"people_holding_hands_light_skin_tone_medium-light_skin_tone\"\n ): \"🧑🏻‍🤝‍🧑🏼\",\n \"people_holding_hands_light_skin_tone_medium_skin_tone\": \"🧑🏻‍🤝‍🧑🏽\",\n \"people_holding_hands_medium-dark_skin_tone\": \"🧑🏾‍🤝‍🧑🏾\",\n \"people_holding_hands_medium-dark_skin_tone_dark_skin_tone\": \"🧑🏾‍🤝‍🧑🏿\",\n \"people_holding_hands_medium-dark_skin_tone_light_skin_tone\": \"🧑🏾‍🤝‍🧑🏻\",\n (\n \"people_holding_hands_medium-dark_skin_tone_medium-light_skin_tone\"\n ): \"🧑🏾‍🤝‍🧑🏼\",\n (\n \"people_holding_hands_medium-dark_skin_tone_medium_skin_tone\"\n ): \"🧑🏾‍🤝‍🧑🏽\",\n \"people_holding_hands_medium-light_skin_tone\": \"🧑🏼‍🤝‍🧑🏼\",\n \"people_holding_hands_medium-light_skin_tone_dark_skin_tone\": \"🧑🏼‍🤝‍🧑🏿\",\n (\n \"people_holding_hands_medium-light_skin_tone_light_skin_tone\"\n ): \"🧑🏼‍🤝‍🧑🏻\",\n (\n \"people_holding_hands_medium-light_skin_tone_medium-dark_skin_tone\"\n ): \"🧑🏼‍🤝‍🧑🏾\",\n (\n \"people_holding_hands_medium-light_skin_tone_medium_skin_tone\"\n ): \"🧑🏼‍🤝‍🧑🏽\",\n \"people_holding_hands_medium_skin_tone\": \"🧑🏽‍🤝‍🧑🏽\",\n \"people_holding_hands_medium_skin_tone_dark_skin_tone\": \"🧑🏽‍🤝‍🧑🏿\",\n \"people_holding_hands_medium_skin_tone_light_skin_tone\": \"🧑🏽‍🤝‍🧑🏻\",\n (\n \"people_holding_hands_medium_skin_tone_medium-dark_skin_tone\"\n ): \"🧑🏽‍🤝‍🧑🏾\",\n (\n \"people_holding_hands_medium_skin_tone_medium-light_skin_tone\"\n ): \"🧑🏽‍🤝‍🧑🏼\",\n \"people_hugging\": \"🫂\",\n \"people_with_bunny_ears\": \"👯\",\n \"people_wrestling\": \"🤼\",\n \"performing_arts\": \"🎭\",\n \"persevering_face\": \"😣\",\n \"person\": \"🧑\",\n \"person_bald\": \"🧑‍🦲\",\n \"person_beard\": \"🧔\",\n \"person_biking\": \"🚴\",\n \"person_biking_dark_skin_tone\": \"🚴🏿\",\n \"person_biking_light_skin_tone\": \"🚴🏻\",\n \"person_biking_medium-dark_skin_tone\": \"🚴🏾\",\n \"person_biking_medium-light_skin_tone\": \"🚴🏼\",\n \"person_biking_medium_skin_tone\": \"🚴🏽\",\n \"person_blond_hair\": \"👱\",\n \"person_bouncing_ball\": \"⛹\",\n \"person_bouncing_ball_dark_skin_tone\": \"⛹🏿\",\n \"person_bouncing_ball_light_skin_tone\": \"⛹🏻\",\n \"person_bouncing_ball_medium-dark_skin_tone\": \"⛹🏾\",\n \"person_bouncing_ball_medium-light_skin_tone\": \"⛹🏼\",\n \"person_bouncing_ball_medium_skin_tone\": \"⛹🏽\",\n \"person_bowing\": \"🙇\",\n \"person_bowing_dark_skin_tone\": \"🙇🏿\",\n \"person_bowing_light_skin_tone\": \"🙇🏻\",\n \"person_bowing_medium-dark_skin_tone\": \"🙇🏾\",\n \"person_bowing_medium-light_skin_tone\": \"🙇🏼\",\n \"person_bowing_medium_skin_tone\": \"🙇🏽\",\n \"person_cartwheeling\": \"🤸\",\n \"person_cartwheeling_dark_skin_tone\": \"🤸🏿\",\n \"person_cartwheeling_light_skin_tone\": \"🤸🏻\",\n \"person_cartwheeling_medium-dark_skin_tone\": \"🤸🏾\",\n \"person_cartwheeling_medium-light_skin_tone\": \"🤸🏼\",\n \"person_cartwheeling_medium_skin_tone\": \"🤸🏽\",\n \"person_climbing\": \"🧗\",\n \"person_climbing_dark_skin_tone\": \"🧗🏿\",\n \"person_climbing_light_skin_tone\": \"🧗🏻\",\n \"person_climbing_medium-dark_skin_tone\": \"🧗🏾\",\n \"person_climbing_medium-light_skin_tone\": \"🧗🏼\",\n \"person_climbing_medium_skin_tone\": \"🧗🏽\",\n \"person_curly_hair\": \"🧑‍🦱\",\n \"person_dark_skin_tone\": \"🧑🏿\",\n \"person_dark_skin_tone_bald\": \"🧑🏿‍🦲\",\n \"person_dark_skin_tone_beard\": \"🧔🏿\",\n \"person_dark_skin_tone_blond_hair\": \"👱🏿\",\n \"person_dark_skin_tone_curly_hair\": \"🧑🏿‍🦱\",\n \"person_dark_skin_tone_red_hair\": \"🧑🏿‍🦰\",\n \"person_dark_skin_tone_white_hair\": \"🧑🏿‍🦳\",\n \"person_facepalming\": \"🤦\",\n \"person_facepalming_dark_skin_tone\": \"🤦🏿\",\n \"person_facepalming_light_skin_tone\": \"🤦🏻\",\n \"person_facepalming_medium-dark_skin_tone\": \"🤦🏾\",\n \"person_facepalming_medium-light_skin_tone\": \"🤦🏼\",\n \"person_facepalming_medium_skin_tone\": \"🤦🏽\",\n \"person_feeding_baby\": \"🧑‍🍼\",\n \"person_feeding_baby_dark_skin_tone\": \"🧑🏿‍🍼\",\n \"person_feeding_baby_light_skin_tone\": \"🧑🏻‍🍼\",\n \"person_feeding_baby_medium-dark_skin_tone\": \"🧑🏾‍🍼\",\n \"person_feeding_baby_medium-light_skin_tone\": \"🧑🏼‍🍼\",\n \"person_feeding_baby_medium_skin_tone\": \"🧑🏽‍🍼\",\n \"person_fencing\": \"🤺\",\n \"person_frowning\": \"🙍\",\n \"person_frowning_dark_skin_tone\": \"🙍🏿\",\n \"person_frowning_light_skin_tone\": \"🙍🏻\",\n \"person_frowning_medium-dark_skin_tone\": \"🙍🏾\",\n \"person_frowning_medium-light_skin_tone\": \"🙍🏼\",\n \"person_frowning_medium_skin_tone\": \"🙍🏽\",\n \"person_gesturing_NO\": \"🙅\",\n \"person_gesturing_NO_dark_skin_tone\": \"🙅🏿\",\n \"person_gesturing_NO_light_skin_tone\": \"🙅🏻\",\n \"person_gesturing_NO_medium-dark_skin_tone\": \"🙅🏾\",\n \"person_gesturing_NO_medium-light_skin_tone\": \"🙅🏼\",\n \"person_gesturing_NO_medium_skin_tone\": \"🙅🏽\",\n \"person_gesturing_OK\": \"🙆\",\n \"person_gesturing_OK_dark_skin_tone\": \"🙆🏿\",\n \"person_gesturing_OK_light_skin_tone\": \"🙆🏻\",\n \"person_gesturing_OK_medium-dark_skin_tone\": \"🙆🏾\",\n \"person_gesturing_OK_medium-light_skin_tone\": \"🙆🏼\",\n \"person_gesturing_OK_medium_skin_tone\": \"🙆🏽\",\n \"person_getting_haircut\": \"💇\",\n \"person_getting_haircut_dark_skin_tone\": \"💇🏿\",\n \"person_getting_haircut_light_skin_tone\": \"💇🏻\",\n \"person_getting_haircut_medium-dark_skin_tone\": \"💇🏾\",\n \"person_getting_haircut_medium-light_skin_tone\": \"💇🏼\",\n \"person_getting_haircut_medium_skin_tone\": \"💇🏽\",\n \"person_getting_massage\": \"💆\",\n \"person_getting_massage_dark_skin_tone\": \"💆🏿\",\n \"person_getting_massage_light_skin_tone\": \"💆🏻\",\n \"person_getting_massage_medium-dark_skin_tone\": \"💆🏾\",\n \"person_getting_massage_medium-light_skin_tone\": \"💆🏼\",\n \"person_getting_massage_medium_skin_tone\": \"💆🏽\",\n \"person_golfing\": \"🏌\",\n \"person_golfing_dark_skin_tone\": \"🏌🏿\",\n \"person_golfing_light_skin_tone\": \"🏌🏻\",\n \"person_golfing_medium-dark_skin_tone\": \"🏌🏾\",\n \"person_golfing_medium-light_skin_tone\": \"🏌🏼\",\n \"person_golfing_medium_skin_tone\": \"🏌🏽\",\n \"person_in_bed\": \"🛌\",\n \"person_in_bed_dark_skin_tone\": \"🛌🏿\",\n \"person_in_bed_light_skin_tone\": \"🛌🏻\",\n \"person_in_bed_medium-dark_skin_tone\": \"🛌🏾\",\n \"person_in_bed_medium-light_skin_tone\": \"🛌🏼\",\n \"person_in_bed_medium_skin_tone\": \"🛌🏽\",\n \"person_in_lotus_position\": \"🧘\",\n \"person_in_lotus_position_dark_skin_tone\": \"🧘🏿\",\n \"person_in_lotus_position_light_skin_tone\": \"🧘🏻\",\n \"person_in_lotus_position_medium-dark_skin_tone\": \"🧘🏾\",\n \"person_in_lotus_position_medium-light_skin_tone\": \"🧘🏼\",\n \"person_in_lotus_position_medium_skin_tone\": \"🧘🏽\",\n \"person_in_manual_wheelchair\": \"🧑‍🦽\",\n \"person_in_manual_wheelchair_dark_skin_tone\": \"🧑🏿‍🦽\",\n \"person_in_manual_wheelchair_light_skin_tone\": \"🧑🏻‍🦽\",\n \"person_in_manual_wheelchair_medium-dark_skin_tone\": \"🧑🏾‍🦽\",\n \"person_in_manual_wheelchair_medium-light_skin_tone\": \"🧑🏼‍🦽\",\n \"person_in_manual_wheelchair_medium_skin_tone\": \"🧑🏽‍🦽\",\n \"person_in_motorized_wheelchair\": \"🧑‍🦼\",\n \"person_in_motorized_wheelchair_dark_skin_tone\": \"🧑🏿‍🦼\",\n \"person_in_motorized_wheelchair_light_skin_tone\": \"🧑🏻‍🦼\",\n \"person_in_motorized_wheelchair_medium-dark_skin_tone\": \"🧑🏾‍🦼\",\n \"person_in_motorized_wheelchair_medium-light_skin_tone\": \"🧑🏼‍🦼\",\n \"person_in_motorized_wheelchair_medium_skin_tone\": \"🧑🏽‍🦼\",\n \"person_in_steamy_room\": \"🧖\",\n \"person_in_steamy_room_dark_skin_tone\": \"🧖🏿\",\n \"person_in_steamy_room_light_skin_tone\": \"🧖🏻\",\n \"person_in_steamy_room_medium-dark_skin_tone\": \"🧖🏾\",\n \"person_in_steamy_room_medium-light_skin_tone\": \"🧖🏼\",\n \"person_in_steamy_room_medium_skin_tone\": \"🧖🏽\",\n \"person_in_suit_levitating\": \"🕴\",\n \"person_in_suit_levitating_dark_skin_tone\": \"🕴🏿\",\n \"person_in_suit_levitating_light_skin_tone\": \"🕴🏻\",\n \"person_in_suit_levitating_medium-dark_skin_tone\": \"🕴🏾\",\n \"person_in_suit_levitating_medium-light_skin_tone\": \"🕴🏼\",\n \"person_in_suit_levitating_medium_skin_tone\": \"🕴🏽\",\n \"person_in_tuxedo\": \"🤵\",\n \"person_in_tuxedo_dark_skin_tone\": \"🤵🏿\",\n \"person_in_tuxedo_light_skin_tone\": \"🤵🏻\",\n \"person_in_tuxedo_medium-dark_skin_tone\": \"🤵🏾\",\n \"person_in_tuxedo_medium-light_skin_tone\": \"🤵🏼\",\n \"person_in_tuxedo_medium_skin_tone\": \"🤵🏽\",\n \"person_juggling\": \"🤹\",\n \"person_juggling_dark_skin_tone\": \"🤹🏿\",\n \"person_juggling_light_skin_tone\": \"🤹🏻\",\n \"person_juggling_medium-dark_skin_tone\": \"🤹🏾\",\n \"person_juggling_medium-light_skin_tone\": \"🤹🏼\",\n \"person_juggling_medium_skin_tone\": \"🤹🏽\",\n \"person_kneeling\": \"🧎\",\n \"person_kneeling_dark_skin_tone\": \"🧎🏿\",\n \"person_kneeling_light_skin_tone\": \"🧎🏻\",\n \"person_kneeling_medium-dark_skin_tone\": \"🧎🏾\",\n \"person_kneeling_medium-light_skin_tone\": \"🧎🏼\",\n \"person_kneeling_medium_skin_tone\": \"🧎🏽\",\n \"person_lifting_weights\": \"🏋\",\n \"person_lifting_weights_dark_skin_tone\": \"🏋🏿\",\n \"person_lifting_weights_light_skin_tone\": \"🏋🏻\",\n \"person_lifting_weights_medium-dark_skin_tone\": \"🏋🏾\",\n \"person_lifting_weights_medium-light_skin_tone\": \"🏋🏼\",\n \"person_lifting_weights_medium_skin_tone\": \"🏋🏽\",\n \"person_light_skin_tone\": \"🧑🏻\",\n \"person_light_skin_tone_bald\": \"🧑🏻‍🦲\",\n \"person_light_skin_tone_beard\": \"🧔🏻\",\n \"person_light_skin_tone_blond_hair\": \"👱🏻\",\n \"person_light_skin_tone_curly_hair\": \"🧑🏻‍🦱\",\n \"person_light_skin_tone_red_hair\": \"🧑🏻‍🦰\",\n \"person_light_skin_tone_white_hair\": \"🧑🏻‍🦳\",\n \"person_medium-dark_skin_tone\": \"🧑🏾\",\n \"person_medium-dark_skin_tone_bald\": \"🧑🏾‍🦲\",\n \"person_medium-dark_skin_tone_beard\": \"🧔🏾\",\n \"person_medium-dark_skin_tone_blond_hair\": \"👱🏾\",\n \"person_medium-dark_skin_tone_curly_hair\": \"🧑🏾‍🦱\",\n \"person_medium-dark_skin_tone_red_hair\": \"🧑🏾‍🦰\",\n \"person_medium-dark_skin_tone_white_hair\": \"🧑🏾‍🦳\",\n \"person_medium-light_skin_tone\": \"🧑🏼\",\n \"person_medium-light_skin_tone_bald\": \"🧑🏼‍🦲\",\n \"person_medium-light_skin_tone_beard\": \"🧔🏼\",\n \"person_medium-light_skin_tone_blond_hair\": \"👱🏼\",\n \"person_medium-light_skin_tone_curly_hair\": \"🧑🏼‍🦱\",\n \"person_medium-light_skin_tone_red_hair\": \"🧑🏼‍🦰\",\n \"person_medium-light_skin_tone_white_hair\": \"🧑🏼‍🦳\",\n \"person_medium_skin_tone\": \"🧑🏽\",\n \"person_medium_skin_tone_bald\": \"🧑🏽‍🦲\",\n \"person_medium_skin_tone_beard\": \"🧔🏽\",\n \"person_medium_skin_tone_blond_hair\": \"👱🏽\",\n \"person_medium_skin_tone_curly_hair\": \"🧑🏽‍🦱\",\n \"person_medium_skin_tone_red_hair\": \"🧑🏽‍🦰\",\n \"person_medium_skin_tone_white_hair\": \"🧑🏽‍🦳\",\n \"person_mountain_biking\": \"🚵\",\n \"person_mountain_biking_dark_skin_tone\": \"🚵🏿\",\n \"person_mountain_biking_light_skin_tone\": \"🚵🏻\",\n \"person_mountain_biking_medium-dark_skin_tone\": \"🚵🏾\",\n \"person_mountain_biking_medium-light_skin_tone\": \"🚵🏼\",\n \"person_mountain_biking_medium_skin_tone\": \"🚵🏽\",\n \"person_playing_handball\": \"🤾\",\n \"person_playing_handball_dark_skin_tone\": \"🤾🏿\",\n \"person_playing_handball_light_skin_tone\": \"🤾🏻\",\n \"person_playing_handball_medium-dark_skin_tone\": \"🤾🏾\",\n \"person_playing_handball_medium-light_skin_tone\": \"🤾🏼\",\n \"person_playing_handball_medium_skin_tone\": \"🤾🏽\",\n \"person_playing_water_polo\": \"🤽\",\n \"person_playing_water_polo_dark_skin_tone\": \"🤽🏿\",\n \"person_playing_water_polo_light_skin_tone\": \"🤽🏻\",\n \"person_playing_water_polo_medium-dark_skin_tone\": \"🤽🏾\",\n \"person_playing_water_polo_medium-light_skin_tone\": \"🤽🏼\",\n \"person_playing_water_polo_medium_skin_tone\": \"🤽🏽\",\n \"person_pouting\": \"🙎\",\n \"person_pouting_dark_skin_tone\": \"🙎🏿\",\n \"person_pouting_light_skin_tone\": \"🙎🏻\",\n \"person_pouting_medium-dark_skin_tone\": \"🙎🏾\",\n \"person_pouting_medium-light_skin_tone\": \"🙎🏼\",\n \"person_pouting_medium_skin_tone\": \"🙎🏽\",\n \"person_raising_hand\": \"🙋\",\n \"person_raising_hand_dark_skin_tone\": \"🙋🏿\",\n \"person_raising_hand_light_skin_tone\": \"🙋🏻\",\n \"person_raising_hand_medium-dark_skin_tone\": \"🙋🏾\",\n \"person_raising_hand_medium-light_skin_tone\": \"🙋🏼\",\n \"person_raising_hand_medium_skin_tone\": \"🙋🏽\",\n \"person_red_hair\": \"🧑‍🦰\",\n \"person_rowing_boat\": \"🚣\",\n \"person_rowing_boat_dark_skin_tone\": \"🚣🏿\",\n \"person_rowing_boat_light_skin_tone\": \"🚣🏻\",\n \"person_rowing_boat_medium-dark_skin_tone\": \"🚣🏾\",\n \"person_rowing_boat_medium-light_skin_tone\": \"🚣🏼\",\n \"person_rowing_boat_medium_skin_tone\": \"🚣🏽\",\n \"person_running\": \"🏃\",\n \"person_running_dark_skin_tone\": \"🏃🏿\",\n \"person_running_light_skin_tone\": \"🏃🏻\",\n \"person_running_medium-dark_skin_tone\": \"🏃🏾\",\n \"person_running_medium-light_skin_tone\": \"🏃🏼\",\n \"person_running_medium_skin_tone\": \"🏃🏽\",\n \"person_shrugging\": \"🤷\",\n \"person_shrugging_dark_skin_tone\": \"🤷🏿\",\n \"person_shrugging_light_skin_tone\": \"🤷🏻\",\n \"person_shrugging_medium-dark_skin_tone\": \"🤷🏾\",\n \"person_shrugging_medium-light_skin_tone\": \"🤷🏼\",\n \"person_shrugging_medium_skin_tone\": \"🤷🏽\",\n \"person_standing\": \"🧍\",\n \"person_standing_dark_skin_tone\": \"🧍🏿\",\n \"person_standing_light_skin_tone\": \"🧍🏻\",\n \"person_standing_medium-dark_skin_tone\": \"🧍🏾\",\n \"person_standing_medium-light_skin_tone\": \"🧍🏼\",\n \"person_standing_medium_skin_tone\": \"🧍🏽\",\n \"person_surfing\": \"🏄\",\n \"person_surfing_dark_skin_tone\": \"🏄🏿\",\n \"person_surfing_light_skin_tone\": \"🏄🏻\",\n \"person_surfing_medium-dark_skin_tone\": \"🏄🏾\",\n \"person_surfing_medium-light_skin_tone\": \"🏄🏼\",\n \"person_surfing_medium_skin_tone\": \"🏄🏽\",\n \"person_swimming\": \"🏊\",\n \"person_swimming_dark_skin_tone\": \"🏊🏿\",\n \"person_swimming_light_skin_tone\": \"🏊🏻\",\n \"person_swimming_medium-dark_skin_tone\": \"🏊🏾\",\n \"person_swimming_medium-light_skin_tone\": \"🏊🏼\",\n \"person_swimming_medium_skin_tone\": \"🏊🏽\",\n \"person_taking_bath\": \"🛀\",\n \"person_taking_bath_dark_skin_tone\": \"🛀🏿\",\n \"person_taking_bath_light_skin_tone\": \"🛀🏻\",\n \"person_taking_bath_medium-dark_skin_tone\": \"🛀🏾\",\n \"person_taking_bath_medium-light_skin_tone\": \"🛀🏼\",\n \"person_taking_bath_medium_skin_tone\": \"🛀🏽\",\n \"person_tipping_hand\": \"💁\",\n \"person_tipping_hand_dark_skin_tone\": \"💁🏿\",\n \"person_tipping_hand_light_skin_tone\": \"💁🏻\",\n \"person_tipping_hand_medium-dark_skin_tone\": \"💁🏾\",\n \"person_tipping_hand_medium-light_skin_tone\": \"💁🏼\",\n \"person_tipping_hand_medium_skin_tone\": \"💁🏽\",\n \"person_walking\": \"🚶\",\n \"person_walking_dark_skin_tone\": \"🚶🏿\",\n \"person_walking_light_skin_tone\": \"🚶🏻\",\n \"person_walking_medium-dark_skin_tone\": \"🚶🏾\",\n \"person_walking_medium-light_skin_tone\": \"🚶🏼\",\n \"person_walking_medium_skin_tone\": \"🚶🏽\",\n \"person_wearing_turban\": \"👳\",\n \"person_wearing_turban_dark_skin_tone\": \"👳🏿\",\n \"person_wearing_turban_light_skin_tone\": \"👳🏻\",\n \"person_wearing_turban_medium-dark_skin_tone\": \"👳🏾\",\n \"person_wearing_turban_medium-light_skin_tone\": \"👳🏼\",\n \"person_wearing_turban_medium_skin_tone\": \"👳🏽\",\n \"person_white_hair\": \"🧑‍🦳\",\n \"person_with_crown\": \"🫅\",\n \"person_with_crown_dark_skin_tone\": \"🫅🏿\",\n \"person_with_crown_light_skin_tone\": \"🫅🏻\",\n \"person_with_crown_medium-dark_skin_tone\": \"🫅🏾\",\n \"person_with_crown_medium-light_skin_tone\": \"🫅🏼\",\n \"person_with_crown_medium_skin_tone\": \"🫅🏽\",\n \"person_with_skullcap\": \"👲\",\n \"person_with_skullcap_dark_skin_tone\": \"👲🏿\",\n \"person_with_skullcap_light_skin_tone\": \"👲🏻\",\n \"person_with_skullcap_medium-dark_skin_tone\": \"👲🏾\",\n \"person_with_skullcap_medium-light_skin_tone\": \"👲🏼\",\n \"person_with_skullcap_medium_skin_tone\": \"👲🏽\",\n \"person_with_veil\": \"👰\",\n \"person_with_veil_dark_skin_tone\": \"👰🏿\",\n \"person_with_veil_light_skin_tone\": \"👰🏻\",\n \"person_with_veil_medium-dark_skin_tone\": \"👰🏾\",\n \"person_with_veil_medium-light_skin_tone\": \"👰🏼\",\n \"person_with_veil_medium_skin_tone\": \"👰🏽\",\n \"person_with_white_cane\": \"🧑‍🦯\",\n \"person_with_white_cane_dark_skin_tone\": \"🧑🏿‍🦯\",\n \"person_with_white_cane_light_skin_tone\": \"🧑🏻‍🦯\",\n \"person_with_white_cane_medium-dark_skin_tone\": \"🧑🏾‍🦯\",\n \"person_with_white_cane_medium-light_skin_tone\": \"🧑🏼‍🦯\",\n \"person_with_white_cane_medium_skin_tone\": \"🧑🏽‍🦯\",\n \"petri_dish\": \"🧫\",\n \"pick\": \"⛏\",\n \"pickup_truck\": \"🛻\",\n \"pie\": \"🥧\",\n \"pig\": \"🐖\",\n \"pig_face\": \"🐷\",\n \"pig_nose\": \"🐽\",\n \"pile_of_poo\": \"💩\",\n \"pill\": \"💊\",\n \"pilot\": \"🧑‍✈\",\n \"pilot_dark_skin_tone\": \"🧑🏿‍✈\",\n \"pilot_light_skin_tone\": \"🧑🏻‍✈\",\n \"pilot_medium-dark_skin_tone\": \"🧑🏾‍✈\",\n \"pilot_medium-light_skin_tone\": \"🧑🏼‍✈\",\n \"pilot_medium_skin_tone\": \"🧑🏽‍✈\",\n \"pinched_fingers\": \"🤌\",\n \"pinched_fingers_dark_skin_tone\": \"🤌🏿\",\n \"pinched_fingers_light_skin_tone\": \"🤌🏻\",\n \"pinched_fingers_medium-dark_skin_tone\": \"🤌🏾\",\n \"pinched_fingers_medium-light_skin_tone\": \"🤌🏼\",\n \"pinched_fingers_medium_skin_tone\": \"🤌🏽\",\n \"pinching_hand\": \"🤏\",\n \"pinching_hand_dark_skin_tone\": \"🤏🏿\",\n \"pinching_hand_light_skin_tone\": \"🤏🏻\",\n \"pinching_hand_medium-dark_skin_tone\": \"🤏🏾\",\n \"pinching_hand_medium-light_skin_tone\": \"🤏🏼\",\n \"pinching_hand_medium_skin_tone\": \"🤏🏽\",\n \"pine_decoration\": \"🎍\",\n \"pineapple\": \"🍍\",\n \"ping_pong\": \"🏓\",\n \"pink_heart\": \"🩷\",\n \"pirate_flag\": \"🏴‍☠\",\n \"pizza\": \"🍕\",\n \"piñata\": \"🪅\",\n \"placard\": \"🪧\",\n \"place_of_worship\": \"🛐\",\n \"play_button\": \"▶\",\n \"play_or_pause_button\": \"⏯\",\n \"playground_slide\": \"🛝\",\n \"pleading_face\": \"🥺\",\n \"plunger\": \"🪠\",\n \"plus\": \"➕\",\n \"polar_bear\": \"🐻‍❄\",\n \"police_car\": \"🚓\",\n \"police_car_light\": \"🚨\",\n \"police_officer\": \"👮\",\n \"police_officer_dark_skin_tone\": \"👮🏿\",\n \"police_officer_light_skin_tone\": \"👮🏻\",\n \"police_officer_medium-dark_skin_tone\": \"👮🏾\",\n \"police_officer_medium-light_skin_tone\": \"👮🏼\",\n \"police_officer_medium_skin_tone\": \"👮🏽\",\n \"poodle\": \"🐩\",\n \"pool_8_ball\": \"🎱\",\n \"popcorn\": \"🍿\",\n \"post_office\": \"🏤\",\n \"postal_horn\": \"📯\",\n \"postbox\": \"📮\",\n \"pot_of_food\": \"🍲\",\n \"potable_water\": \"🚰\",\n \"potato\": \"🥔\",\n \"potted_plant\": \"🪴\",\n \"poultry_leg\": \"🍗\",\n \"pound_banknote\": \"💷\",\n \"pouring_liquid\": \"🫗\",\n \"pouting_cat\": \"😾\",\n \"prayer_beads\": \"📿\",\n \"pregnant_man\": \"🫃\",\n \"pregnant_man_dark_skin_tone\": \"🫃🏿\",\n \"pregnant_man_light_skin_tone\": \"🫃🏻\",\n \"pregnant_man_medium-dark_skin_tone\": \"🫃🏾\",\n \"pregnant_man_medium-light_skin_tone\": \"🫃🏼\",\n \"pregnant_man_medium_skin_tone\": \"🫃🏽\",\n \"pregnant_person\": \"🫄\",\n \"pregnant_person_dark_skin_tone\": \"🫄🏿\",\n \"pregnant_person_light_skin_tone\": \"🫄🏻\",\n \"pregnant_person_medium-dark_skin_tone\": \"🫄🏾\",\n \"pregnant_person_medium-light_skin_tone\": \"🫄🏼\",\n \"pregnant_person_medium_skin_tone\": \"🫄🏽\",\n \"pregnant_woman\": \"🤰\",\n \"pregnant_woman_dark_skin_tone\": \"🤰🏿\",\n \"pregnant_woman_light_skin_tone\": \"🤰🏻\",\n \"pregnant_woman_medium-dark_skin_tone\": \"🤰🏾\",\n \"pregnant_woman_medium-light_skin_tone\": \"🤰🏼\",\n \"pregnant_woman_medium_skin_tone\": \"🤰🏽\",\n \"pretzel\": \"🥨\",\n \"prince\": \"🤴\",\n \"prince_dark_skin_tone\": \"🤴🏿\",\n \"prince_light_skin_tone\": \"🤴🏻\",\n \"prince_medium-dark_skin_tone\": \"🤴🏾\",\n \"prince_medium-light_skin_tone\": \"🤴🏼\",\n \"prince_medium_skin_tone\": \"🤴🏽\",\n \"princess\": \"👸\",\n \"princess_dark_skin_tone\": \"👸🏿\",\n \"princess_light_skin_tone\": \"👸🏻\",\n \"princess_medium-dark_skin_tone\": \"👸🏾\",\n \"princess_medium-light_skin_tone\": \"👸🏼\",\n \"princess_medium_skin_tone\": \"👸🏽\",\n \"printer\": \"🖨\",\n \"prohibited\": \"🚫\",\n \"purple_circle\": \"🟣\",\n \"purple_heart\": \"💜\",\n \"purple_square\": \"🟪\",\n \"purse\": \"👛\",\n \"pushpin\": \"📌\",\n \"puzzle_piece\": \"🧩\",\n \"rabbit\": \"🐇\",\n \"rabbit_face\": \"🐰\",\n \"raccoon\": \"🦝\",\n \"racing_car\": \"🏎\",\n \"radio\": \"📻\",\n \"radio_button\": \"🔘\",\n \"radioactive\": \"☢\",\n \"railway_car\": \"🚃\",\n \"railway_track\": \"🛤\",\n \"rainbow\": \"🌈\",\n \"rainbow_flag\": \"🏳‍🌈\",\n \"raised_back_of_hand\": \"🤚\",\n \"raised_back_of_hand_dark_skin_tone\": \"🤚🏿\",\n \"raised_back_of_hand_light_skin_tone\": \"🤚🏻\",\n \"raised_back_of_hand_medium-dark_skin_tone\": \"🤚🏾\",\n \"raised_back_of_hand_medium-light_skin_tone\": \"🤚🏼\",\n \"raised_back_of_hand_medium_skin_tone\": \"🤚🏽\",\n \"raised_fist\": \"✊\",\n \"raised_fist_dark_skin_tone\": \"✊🏿\",\n \"raised_fist_light_skin_tone\": \"✊🏻\",\n \"raised_fist_medium-dark_skin_tone\": \"✊🏾\",\n \"raised_fist_medium-light_skin_tone\": \"✊🏼\",\n \"raised_fist_medium_skin_tone\": \"✊🏽\",\n \"raised_hand\": \"✋\",\n \"raised_hand_dark_skin_tone\": \"✋🏿\",\n \"raised_hand_light_skin_tone\": \"✋🏻\",\n \"raised_hand_medium-dark_skin_tone\": \"✋🏾\",\n \"raised_hand_medium-light_skin_tone\": \"✋🏼\",\n \"raised_hand_medium_skin_tone\": \"✋🏽\",\n \"raising_hands\": \"🙌\",\n \"raising_hands_dark_skin_tone\": \"🙌🏿\",\n \"raising_hands_light_skin_tone\": \"🙌🏻\",\n \"raising_hands_medium-dark_skin_tone\": \"🙌🏾\",\n \"raising_hands_medium-light_skin_tone\": \"🙌🏼\",\n \"raising_hands_medium_skin_tone\": \"🙌🏽\",\n \"ram\": \"🐏\",\n \"rat\": \"🐀\",\n \"razor\": \"🪒\",\n \"receipt\": \"🧾\",\n \"record_button\": \"⏺\",\n \"recycling_symbol\": \"♻\",\n \"red_apple\": \"🍎\",\n \"red_circle\": \"🔴\",\n \"red_envelope\": \"🧧\",\n \"red_exclamation_mark\": \"❗\",\n \"red_hair\": \"🦰\",\n \"red_heart\": \"❤\",\n \"red_paper_lantern\": \"🏮\",\n \"red_question_mark\": \"❓\",\n \"red_square\": \"🟥\",\n \"red_triangle_pointed_down\": \"🔻\",\n \"red_triangle_pointed_up\": \"🔺\",\n \"registered\": \"®\",\n \"relieved_face\": \"😌\",\n \"reminder_ribbon\": \"🎗\",\n \"repeat_button\": \"🔁\",\n \"repeat_single_button\": \"🔂\",\n \"rescue_worker’s_helmet\": \"⛑\",\n \"restroom\": \"🚻\",\n \"reverse_button\": \"◀\",\n \"revolving_hearts\": \"💞\",\n \"rhinoceros\": \"🦏\",\n \"ribbon\": \"🎀\",\n \"rice_ball\": \"🍙\",\n \"rice_cracker\": \"🍘\",\n \"right-facing_fist\": \"🤜\",\n \"right-facing_fist_dark_skin_tone\": \"🤜🏿\",\n \"right-facing_fist_light_skin_tone\": \"🤜🏻\",\n \"right-facing_fist_medium-dark_skin_tone\": \"🤜🏾\",\n \"right-facing_fist_medium-light_skin_tone\": \"🤜🏼\",\n \"right-facing_fist_medium_skin_tone\": \"🤜🏽\",\n \"right_anger_bubble\": \"🗯\",\n \"right_arrow\": \"➡\",\n \"right_arrow_curving_down\": \"⤵\",\n \"right_arrow_curving_left\": \"↩\",\n \"right_arrow_curving_up\": \"⤴\",\n \"rightwards_hand\": \"🫱\",\n \"rightwards_hand_dark_skin_tone\": \"🫱🏿\",\n \"rightwards_hand_light_skin_tone\": \"🫱🏻\",\n \"rightwards_hand_medium-dark_skin_tone\": \"🫱🏾\",\n \"rightwards_hand_medium-light_skin_tone\": \"🫱🏼\",\n \"rightwards_hand_medium_skin_tone\": \"🫱🏽\",\n \"rightwards_pushing_hand\": \"🫸\",\n \"rightwards_pushing_hand_dark_skin_tone\": \"🫸🏿\",\n \"rightwards_pushing_hand_light_skin_tone\": \"🫸🏻\",\n \"rightwards_pushing_hand_medium-dark_skin_tone\": \"🫸🏾\",\n \"rightwards_pushing_hand_medium-light_skin_tone\": \"🫸🏼\",\n \"rightwards_pushing_hand_medium_skin_tone\": \"🫸🏽\",\n \"ring\": \"💍\",\n \"ring_buoy\": \"🛟\",\n \"ringed_planet\": \"🪐\",\n \"roasted_sweet_potato\": \"🍠\",\n \"robot\": \"🤖\",\n \"rock\": \"🪨\",\n \"rocket\": \"🚀\",\n \"roll_of_paper\": \"🧻\",\n \"rolled-up_newspaper\": \"🗞\",\n \"roller_coaster\": \"🎢\",\n \"roller_skate\": \"🛼\",\n \"rolling_on_the_floor_laughing\": \"🤣\",\n \"rooster\": \"🐓\",\n \"rose\": \"🌹\",\n \"rosette\": \"🏵\",\n \"round_pushpin\": \"📍\",\n \"rugby_football\": \"🏉\",\n \"running_shirt\": \"🎽\",\n \"running_shoe\": \"👟\",\n \"sad_but_relieved_face\": \"😥\",\n \"safety_pin\": \"🧷\",\n \"safety_vest\": \"🦺\",\n \"sailboat\": \"⛵\",\n \"sake\": \"🍶\",\n \"salt\": \"🧂\",\n \"saluting_face\": \"🫡\",\n \"sandwich\": \"🥪\",\n \"sari\": \"🥻\",\n \"satellite\": \"🛰\",\n \"satellite_antenna\": \"📡\",\n \"sauropod\": \"🦕\",\n \"saxophone\": \"🎷\",\n \"scarf\": \"🧣\",\n \"school\": \"🏫\",\n \"scientist\": \"🧑‍🔬\",\n \"scientist_dark_skin_tone\": \"🧑🏿‍🔬\",\n \"scientist_light_skin_tone\": \"🧑🏻‍🔬\",\n \"scientist_medium-dark_skin_tone\": \"🧑🏾‍🔬\",\n \"scientist_medium-light_skin_tone\": \"🧑🏼‍🔬\",\n \"scientist_medium_skin_tone\": \"🧑🏽‍🔬\",\n \"scissors\": \"✂\",\n \"scorpion\": \"🦂\",\n \"screwdriver\": \"🪛\",\n \"scroll\": \"📜\",\n \"seal\": \"🦭\",\n \"seat\": \"💺\",\n \"see-no-evil_monkey\": \"🙈\",\n \"see_no_evil\": \"🙈\",\n \"seedling\": \"🌱\",\n \"selfie\": \"🤳\",\n \"selfie_dark_skin_tone\": \"🤳🏿\",\n \"selfie_light_skin_tone\": \"🤳🏻\",\n \"selfie_medium-dark_skin_tone\": \"🤳🏾\",\n \"selfie_medium-light_skin_tone\": \"🤳🏼\",\n \"selfie_medium_skin_tone\": \"🤳🏽\",\n \"service_dog\": \"🐕‍🦺\",\n \"seven-thirty\": \"🕢\",\n \"seven_o’clock\": \"🕖\",\n \"sewing_needle\": \"🪡\",\n \"shaking_face\": \"🫨\",\n \"shallow_pan_of_food\": \"🥘\",\n \"shamrock\": \"☘\",\n \"shark\": \"🦈\",\n \"shaved_ice\": \"🍧\",\n \"sheaf_of_rice\": \"🌾\",\n \"shield\": \"🛡\",\n \"shinto_shrine\": \"⛩\",\n \"ship\": \"🚢\",\n \"shooting_star\": \"🌠\",\n \"shopping_bags\": \"🛍\",\n \"shopping_cart\": \"🛒\",\n \"shortcake\": \"🍰\",\n \"shorts\": \"🩳\",\n \"shower\": \"🚿\",\n \"shrimp\": \"🦐\",\n \"shuffle_tracks_button\": \"🔀\",\n \"shushing_face\": \"🤫\",\n \"sign_of_the_horns\": \"🤘\",\n \"sign_of_the_horns_dark_skin_tone\": \"🤘🏿\",\n \"sign_of_the_horns_light_skin_tone\": \"🤘🏻\",\n \"sign_of_the_horns_medium-dark_skin_tone\": \"🤘🏾\",\n \"sign_of_the_horns_medium-light_skin_tone\": \"🤘🏼\",\n \"sign_of_the_horns_medium_skin_tone\": \"🤘🏽\",\n \"singer\": \"🧑‍🎤\",\n \"singer_dark_skin_tone\": \"🧑🏿‍🎤\",\n \"singer_light_skin_tone\": \"🧑🏻‍🎤\",\n \"singer_medium-dark_skin_tone\": \"🧑🏾‍🎤\",\n \"singer_medium-light_skin_tone\": \"🧑🏼‍🎤\",\n \"singer_medium_skin_tone\": \"🧑🏽‍🎤\",\n \"six-thirty\": \"🕡\",\n \"six_o’clock\": \"🕕\",\n \"skateboard\": \"🛹\",\n \"skier\": \"⛷\",\n \"skis\": \"🎿\",\n \"skull\": \"💀\",\n \"skull_and_crossbones\": \"☠\",\n \"skunk\": \"🦨\",\n \"sled\": \"🛷\",\n \"sleeping_face\": \"😴\",\n \"sleepy_face\": \"😪\",\n \"slightly_frowning_face\": \"🙁\",\n \"slightly_smiling_face\": \"🙂\",\n \"slot_machine\": \"🎰\",\n \"sloth\": \"🦥\",\n \"small_airplane\": \"🛩\",\n \"small_blue_diamond\": \"🔹\",\n \"small_orange_diamond\": \"🔸\",\n \"smiling_cat_with_heart-eyes\": \"😻\",\n \"smiling_face\": \"☺\",\n \"smiling_face_with_halo\": \"😇\",\n \"smiling_face_with_heart-eyes\": \"😍\",\n \"smiling_face_with_hearts\": \"🥰\",\n \"smiling_face_with_horns\": \"😈\",\n \"smiling_face_with_open_hands\": \"🤗\",\n \"smiling_face_with_smiling_eyes\": \"😊\",\n \"smiling_face_with_sunglasses\": \"😎\",\n \"smiling_face_with_tear\": \"🥲\",\n \"smirking_face\": \"😏\",\n \"snail\": \"🐌\",\n \"snake\": \"🐍\",\n \"sneezing_face\": \"🤧\",\n \"snow-capped_mountain\": \"🏔\",\n \"snowboarder\": \"🏂\",\n \"snowboarder_dark_skin_tone\": \"🏂🏿\",\n \"snowboarder_light_skin_tone\": \"🏂🏻\",\n \"snowboarder_medium-dark_skin_tone\": \"🏂🏾\",\n \"snowboarder_medium-light_skin_tone\": \"🏂🏼\",\n \"snowboarder_medium_skin_tone\": \"🏂🏽\",\n \"snowflake\": \"❄\",\n \"snowman\": \"☃\",\n \"snowman_without_snow\": \"⛄\",\n \"soap\": \"🧼\",\n \"soccer_ball\": \"⚽\",\n \"socks\": \"🧦\",\n \"soft_ice_cream\": \"🍦\",\n \"softball\": \"🥎\",\n \"spade_suit\": \"♠\",\n \"spaghetti\": \"🍝\",\n \"sparkle\": \"❇\",\n \"sparkler\": \"🎇\",\n \"sparkles\": \"✨\",\n \"sparkling_heart\": \"💖\",\n \"speak-no-evil_monkey\": \"🙊\",\n \"speaker_high_volume\": \"🔊\",\n \"speaker_low_volume\": \"🔈\",\n \"speaker_medium_volume\": \"🔉\",\n \"speaking_head\": \"🗣\",\n \"speech_balloon\": \"💬\",\n \"speedboat\": \"🚤\",\n \"spider\": \"🕷\",\n \"spider_web\": \"🕸\",\n \"spiral_calendar\": \"🗓\",\n \"spiral_notepad\": \"🗒\",\n \"spiral_shell\": \"🐚\",\n \"sponge\": \"🧽\",\n \"spoon\": \"🥄\",\n \"sport_utility_vehicle\": \"🚙\",\n \"sports_medal\": \"🏅\",\n \"spouting_whale\": \"🐳\",\n \"squid\": \"🦑\",\n \"squinting_face_with_tongue\": \"😝\",\n \"stadium\": \"🏟\",\n \"star\": \"⭐\",\n \"star-struck\": \"🤩\",\n \"star_and_crescent\": \"☪\",\n \"star_of_David\": \"✡\",\n \"station\": \"🚉\",\n \"steaming_bowl\": \"🍜\",\n \"stethoscope\": \"🩺\",\n \"stop_button\": \"⏹\",\n \"stop_sign\": \"🛑\",\n \"stopwatch\": \"⏱\",\n \"straight_ruler\": \"📏\",\n \"strawberry\": \"🍓\",\n \"student\": \"🧑‍🎓\",\n \"student_dark_skin_tone\": \"🧑🏿‍🎓\",\n \"student_light_skin_tone\": \"🧑🏻‍🎓\",\n \"student_medium-dark_skin_tone\": \"🧑🏾‍🎓\",\n \"student_medium-light_skin_tone\": \"🧑🏼‍🎓\",\n \"student_medium_skin_tone\": \"🧑🏽‍🎓\",\n \"studio_microphone\": \"🎙\",\n \"stuffed_flatbread\": \"🥙\",\n \"sun\": \"☀\",\n \"sun_behind_cloud\": \"⛅\",\n \"sun_behind_large_cloud\": \"🌥\",\n \"sun_behind_rain_cloud\": \"🌦\",\n \"sun_behind_small_cloud\": \"🌤\",\n \"sun_with_face\": \"🌞\",\n \"sunflower\": \"🌻\",\n \"sunglasses\": \"🕶\",\n \"sunrise\": \"🌅\",\n \"sunrise_over_mountains\": \"🌄\",\n \"sunset\": \"🌇\",\n \"superhero\": \"🦸\",\n \"superhero_dark_skin_tone\": \"🦸🏿\",\n \"superhero_light_skin_tone\": \"🦸🏻\",\n \"superhero_medium-dark_skin_tone\": \"🦸🏾\",\n \"superhero_medium-light_skin_tone\": \"🦸🏼\",\n \"superhero_medium_skin_tone\": \"🦸🏽\",\n \"supervillain\": \"🦹\",\n \"supervillain_dark_skin_tone\": \"🦹🏿\",\n \"supervillain_light_skin_tone\": \"🦹🏻\",\n \"supervillain_medium-dark_skin_tone\": \"🦹🏾\",\n \"supervillain_medium-light_skin_tone\": \"🦹🏼\",\n \"supervillain_medium_skin_tone\": \"🦹🏽\",\n \"sushi\": \"🍣\",\n \"suspension_railway\": \"🚟\",\n \"swan\": \"🦢\",\n \"sweat_droplets\": \"💦\",\n \"synagogue\": \"🕍\",\n \"syringe\": \"💉\",\n \"t-shirt\": \"👕\",\n \"taco\": \"🌮\",\n \"takeout_box\": \"🥡\",\n \"tamale\": \"🫔\",\n \"tanabata_tree\": \"🎋\",\n \"tangerine\": \"🍊\",\n \"taxi\": \"🚕\",\n \"teacher\": \"🧑‍🏫\",\n \"teacher_dark_skin_tone\": \"🧑🏿‍🏫\",\n \"teacher_light_skin_tone\": \"🧑🏻‍🏫\",\n \"teacher_medium-dark_skin_tone\": \"🧑🏾‍🏫\",\n \"teacher_medium-light_skin_tone\": \"🧑🏼‍🏫\",\n \"teacher_medium_skin_tone\": \"🧑🏽‍🏫\",\n \"teacup_without_handle\": \"🍵\",\n \"teapot\": \"🫖\",\n \"tear-off_calendar\": \"📆\",\n \"technologist\": \"🧑‍💻\",\n \"technologist_dark_skin_tone\": \"🧑🏿‍💻\",\n \"technologist_light_skin_tone\": \"🧑🏻‍💻\",\n \"technologist_medium-dark_skin_tone\": \"🧑🏾‍💻\",\n \"technologist_medium-light_skin_tone\": \"🧑🏼‍💻\",\n \"technologist_medium_skin_tone\": \"🧑🏽‍💻\",\n \"teddy_bear\": \"🧸\",\n \"telephone\": \"☎\",\n \"telephone_receiver\": \"📞\",\n \"telescope\": \"🔭\",\n \"television\": \"📺\",\n \"ten-thirty\": \"🕥\",\n \"ten_o’clock\": \"🕙\",\n \"tennis\": \"🎾\",\n \"tent\": \"⛺\",\n \"test_tube\": \"🧪\",\n \"thermometer\": \"🌡\",\n \"thinking_face\": \"🤔\",\n \"thong_sandal\": \"🩴\",\n \"thought_balloon\": \"💭\",\n \"thread\": \"🧵\",\n \"three-thirty\": \"🕞\",\n \"three_o’clock\": \"🕒\",\n \"thumbs_down\": \"👎\",\n \"thumbs_down_dark_skin_tone\": \"👎🏿\",\n \"thumbs_down_light_skin_tone\": \"👎🏻\",\n \"thumbs_down_medium-dark_skin_tone\": \"👎🏾\",\n \"thumbs_down_medium-light_skin_tone\": \"👎🏼\",\n \"thumbs_down_medium_skin_tone\": \"👎🏽\",\n \"thumbs_up\": \"👍\",\n \"thumbs_up_dark_skin_tone\": \"👍🏿\",\n \"thumbs_up_light_skin_tone\": \"👍🏻\",\n \"thumbs_up_medium-dark_skin_tone\": \"👍🏾\",\n \"thumbs_up_medium-light_skin_tone\": \"👍🏼\",\n \"thumbs_up_medium_skin_tone\": \"👍🏽\",\n \"ticket\": \"🎫\",\n \"tiger\": \"🐅\",\n \"tiger_face\": \"🐯\",\n \"timer_clock\": \"⏲\",\n \"tired_face\": \"😫\",\n \"toilet\": \"🚽\",\n \"tomato\": \"🍅\",\n \"tongue\": \"👅\",\n \"toolbox\": \"🧰\",\n \"tooth\": \"🦷\",\n \"toothbrush\": \"🪥\",\n \"top_hat\": \"🎩\",\n \"tornado\": \"🌪\",\n \"trackball\": \"🖲\",\n \"tractor\": \"🚜\",\n \"trade_mark\": \"™\",\n \"train\": \"🚆\",\n \"tram\": \"🚊\",\n \"tram_car\": \"🚋\",\n \"transgender_flag\": \"🏳‍⚧\",\n \"transgender_symbol\": \"⚧\",\n \"triangular_flag\": \"🚩\",\n \"triangular_ruler\": \"📐\",\n \"trident_emblem\": \"🔱\",\n \"troll\": \"🧌\",\n \"trolleybus\": \"🚎\",\n \"trophy\": \"🏆\",\n \"tropical_drink\": \"🍹\",\n \"tropical_fish\": \"🐠\",\n \"trumpet\": \"🎺\",\n \"tulip\": \"🌷\",\n \"tumbler_glass\": \"🥃\",\n \"turkey\": \"🦃\",\n \"turtle\": \"🐢\",\n \"twelve-thirty\": \"🕧\",\n \"twelve_o’clock\": \"🕛\",\n \"two-hump_camel\": \"🐫\",\n \"two-thirty\": \"🕝\",\n \"two_hearts\": \"💕\",\n \"two_o’clock\": \"🕑\",\n \"umbrella\": \"☂\",\n \"umbrella_on_ground\": \"⛱\",\n \"umbrella_with_rain_drops\": \"☔\",\n \"unamused_face\": \"😒\",\n \"unicorn\": \"🦄\",\n \"unlocked\": \"🔓\",\n \"up-down_arrow\": \"↕\",\n \"up-left_arrow\": \"↖\",\n \"up-right_arrow\": \"↗\",\n \"up_arrow\": \"⬆\",\n \"upside-down_face\": \"🙃\",\n \"upwards_button\": \"🔼\",\n \"vampire\": \"🧛\",\n \"vampire_dark_skin_tone\": \"🧛🏿\",\n \"vampire_light_skin_tone\": \"🧛🏻\",\n \"vampire_medium-dark_skin_tone\": \"🧛🏾\",\n \"vampire_medium-light_skin_tone\": \"🧛🏼\",\n \"vampire_medium_skin_tone\": \"🧛🏽\",\n \"vertical_traffic_light\": \"🚦\",\n \"vibration_mode\": \"📳\",\n \"victory_hand\": \"✌\",\n \"victory_hand_dark_skin_tone\": \"✌🏿\",\n \"victory_hand_light_skin_tone\": \"✌🏻\",\n \"victory_hand_medium-dark_skin_tone\": \"✌🏾\",\n \"victory_hand_medium-light_skin_tone\": \"✌🏼\",\n \"victory_hand_medium_skin_tone\": \"✌🏽\",\n \"video_camera\": \"📹\",\n \"video_game\": \"🎮\",\n \"videocassette\": \"📼\",\n \"violin\": \"🎻\",\n \"volcano\": \"🌋\",\n \"volleyball\": \"🏐\",\n \"vulcan_salute\": \"🖖\",\n \"vulcan_salute_dark_skin_tone\": \"🖖🏿\",\n \"vulcan_salute_light_skin_tone\": \"🖖🏻\",\n \"vulcan_salute_medium-dark_skin_tone\": \"🖖🏾\",\n \"vulcan_salute_medium-light_skin_tone\": \"🖖🏼\",\n \"vulcan_salute_medium_skin_tone\": \"🖖🏽\",\n \"waffle\": \"🧇\",\n \"waning_crescent_moon\": \"🌘\",\n \"waning_gibbous_moon\": \"🌖\",\n \"warning\": \"⚠\",\n \"wastebasket\": \"🗑\",\n \"watch\": \"⌚\",\n \"water_buffalo\": \"🐃\",\n \"water_closet\": \"🚾\",\n \"water_pistol\": \"🔫\",\n \"water_wave\": \"🌊\",\n \"watermelon\": \"🍉\",\n \"waving_hand\": \"👋\",\n \"waving_hand_dark_skin_tone\": \"👋🏿\",\n \"waving_hand_light_skin_tone\": \"👋🏻\",\n \"waving_hand_medium-dark_skin_tone\": \"👋🏾\",\n \"waving_hand_medium-light_skin_tone\": \"👋🏼\",\n \"waving_hand_medium_skin_tone\": \"👋🏽\",\n \"wavy_dash\": \"〰\",\n \"waxing_crescent_moon\": \"🌒\",\n \"waxing_gibbous_moon\": \"🌔\",\n \"weary_cat\": \"🙀\",\n \"weary_face\": \"😩\",\n \"wedding\": \"💒\",\n \"whale\": \"🐋\",\n \"wheel\": \"🛞\",\n \"wheel_of_dharma\": \"☸\",\n \"wheelchair_symbol\": \"♿\",\n \"white_cane\": \"🦯\",\n \"white_circle\": \"⚪\",\n \"white_exclamation_mark\": \"❕\",\n \"white_flag\": \"🏳\",\n \"white_flower\": \"💮\",\n \"white_hair\": \"🦳\",\n \"white_heart\": \"🤍\",\n \"white_large_square\": \"⬜\",\n \"white_medium-small_square\": \"◽\",\n \"white_medium_square\": \"◻\",\n \"white_question_mark\": \"❔\",\n \"white_small_square\": \"▫\",\n \"white_square_button\": \"🔳\",\n \"wilted_flower\": \"🥀\",\n \"wind_chime\": \"🎐\",\n \"wind_face\": \"🌬\",\n \"window\": \"🪟\",\n \"wine_glass\": \"🍷\",\n \"wing\": \"🪽\",\n \"winking_face\": \"😉\",\n \"winking_face_with_tongue\": \"😜\",\n \"wireless\": \"🛜\",\n \"wolf\": \"🐺\",\n \"woman\": \"👩\",\n \"woman_and_man_holding_hands\": \"👫\",\n \"woman_and_man_holding_hands_dark_skin_tone\": \"👫🏿\",\n \"woman_and_man_holding_hands_dark_skin_tone_light_skin_tone\": \"👩🏿‍🤝‍👨🏻\",\n (\n \"woman_and_man_holding_hands_dark_skin_tone_medium-dark_skin_tone\"\n ): \"👩🏿‍🤝‍👨🏾\",\n (\n \"woman_and_man_holding_hands_dark_skin_tone_medium-light_skin_tone\"\n ): \"👩🏿‍🤝‍👨🏼\",\n (\n \"woman_and_man_holding_hands_dark_skin_tone_medium_skin_tone\"\n ): \"👩🏿‍🤝‍👨🏽\",\n \"woman_and_man_holding_hands_light_skin_tone\": \"👫🏻\",\n \"woman_and_man_holding_hands_light_skin_tone_dark_skin_tone\": \"👩🏻‍🤝‍👨🏿\",\n (\n \"woman_and_man_holding_hands_light_skin_tone_medium-dark_skin_tone\"\n ): \"👩🏻‍🤝‍👨🏾\",\n (\n \"woman_and_man_holding_hands_light_skin_tone_medium-light_skin_tone\"\n ): \"👩🏻‍🤝‍👨🏼\",\n (\n \"woman_and_man_holding_hands_light_skin_tone_medium_skin_tone\"\n ): \"👩🏻‍🤝‍👨🏽\",\n \"woman_and_man_holding_hands_medium-dark_skin_tone\": \"👫🏾\",\n (\n \"woman_and_man_holding_hands_medium-dark_skin_tone_dark_skin_tone\"\n ): \"👩🏾‍🤝‍👨🏿\",\n (\n \"woman_and_man_holding_hands_medium-dark_skin_tone_light_skin_tone\"\n ): \"👩🏾‍🤝‍👨🏻\",\n (\n \"woman_and_man_holding_hands_medium\"\n \"-dark_skin_tone_medium-light_skin_tone\"\n ): \"👩🏾‍🤝‍👨🏼\",\n (\n \"woman_and_man_holding_hands_medium-dark_skin_tone_medium_skin_tone\"\n ): \"👩🏾‍🤝‍👨🏽\",\n \"woman_and_man_holding_hands_medium-light_skin_tone\": \"👫🏼\",\n (\n \"woman_and_man_holding_hands_medium-light_skin_tone_dark_skin_tone\"\n ): \"👩🏼‍🤝‍👨🏿\",\n (\n \"woman_and_man_holding_hands_medium-light_skin_tone_light_skin_tone\"\n ): \"👩🏼‍🤝‍👨🏻\",\n (\n \"woman_and_man_holding_hands_medium-\"\n \"light_skin_tone_medium-dark_skin_tone\"\n ): \"👩🏼‍🤝‍👨🏾\",\n (\n \"woman_and_man_holding_hands_medium-light_skin_tone_medium_skin_tone\"\n ): \"👩🏼‍🤝‍👨🏽\",\n \"woman_and_man_holding_hands_medium_skin_tone\": \"👫🏽\",\n (\n \"woman_and_man_holding_hands_medium_skin_tone_dark_skin_tone\"\n ): \"👩🏽‍🤝‍👨🏿\",\n (\n \"woman_and_man_holding_hands_medium_skin_tone_light_skin_tone\"\n ): \"👩🏽‍🤝‍👨🏻\",\n (\n \"woman_and_man_holding_hands_medium_skin_tone_medium-dark_skin_tone\"\n ): \"👩🏽‍🤝‍👨🏾\",\n (\n \"woman_and_man_holding_hands_medium_skin_tone_medium-light_skin_tone\"\n ): \"👩🏽‍🤝‍👨🏼\",\n \"woman_artist\": \"👩‍🎨\",\n \"woman_artist_dark_skin_tone\": \"👩🏿‍🎨\",\n \"woman_artist_light_skin_tone\": \"👩🏻‍🎨\",\n \"woman_artist_medium-dark_skin_tone\": \"👩🏾‍🎨\",\n \"woman_artist_medium-light_skin_tone\": \"👩🏼‍🎨\",\n \"woman_artist_medium_skin_tone\": \"👩🏽‍🎨\",\n \"woman_astronaut\": \"👩‍🚀\",\n \"woman_astronaut_dark_skin_tone\": \"👩🏿‍🚀\",\n \"woman_astronaut_light_skin_tone\": \"👩🏻‍🚀\",\n \"woman_astronaut_medium-dark_skin_tone\": \"👩🏾‍🚀\",\n \"woman_astronaut_medium-light_skin_tone\": \"👩🏼‍🚀\",\n \"woman_astronaut_medium_skin_tone\": \"👩🏽‍🚀\",\n \"woman_bald\": \"👩‍🦲\",\n \"woman_beard\": \"🧔‍♀\",\n \"woman_biking\": \"🚴‍♀\",\n \"woman_biking_dark_skin_tone\": \"🚴🏿‍♀\",\n \"woman_biking_light_skin_tone\": \"🚴🏻‍♀\",\n \"woman_biking_medium-dark_skin_tone\": \"🚴🏾‍♀\",\n \"woman_biking_medium-light_skin_tone\": \"🚴🏼‍♀\",\n \"woman_biking_medium_skin_tone\": \"🚴🏽‍♀\",\n \"woman_blond_hair\": \"👱‍♀\",\n \"woman_bouncing_ball\": \"⛹‍♀\",\n \"woman_bouncing_ball_dark_skin_tone\": \"⛹🏿‍♀\",\n \"woman_bouncing_ball_light_skin_tone\": \"⛹🏻‍♀\",\n \"woman_bouncing_ball_medium-dark_skin_tone\": \"⛹🏾‍♀\",\n \"woman_bouncing_ball_medium-light_skin_tone\": \"⛹🏼‍♀\",\n \"woman_bouncing_ball_medium_skin_tone\": \"⛹🏽‍♀\",\n \"woman_bowing\": \"🙇‍♀\",\n \"woman_bowing_dark_skin_tone\": \"🙇🏿‍♀\",\n \"woman_bowing_light_skin_tone\": \"🙇🏻‍♀\",\n \"woman_bowing_medium-dark_skin_tone\": \"🙇🏾‍♀\",\n \"woman_bowing_medium-light_skin_tone\": \"🙇🏼‍♀\",\n \"woman_bowing_medium_skin_tone\": \"🙇🏽‍♀\",\n \"woman_cartwheeling\": \"🤸‍♀\",\n \"woman_cartwheeling_dark_skin_tone\": \"🤸🏿‍♀\",\n \"woman_cartwheeling_light_skin_tone\": \"🤸🏻‍♀\",\n \"woman_cartwheeling_medium-dark_skin_tone\": \"🤸🏾‍♀\",\n \"woman_cartwheeling_medium-light_skin_tone\": \"🤸🏼‍♀\",\n \"woman_cartwheeling_medium_skin_tone\": \"🤸🏽‍♀\",\n \"woman_climbing\": \"🧗‍♀\",\n \"woman_climbing_dark_skin_tone\": \"🧗🏿‍♀\",\n \"woman_climbing_light_skin_tone\": \"🧗🏻‍♀\",\n \"woman_climbing_medium-dark_skin_tone\": \"🧗🏾‍♀\",\n \"woman_climbing_medium-light_skin_tone\": \"🧗🏼‍♀\",\n \"woman_climbing_medium_skin_tone\": \"🧗🏽‍♀\",\n \"woman_construction_worker\": \"👷‍♀\",\n \"woman_construction_worker_dark_skin_tone\": \"👷🏿‍♀\",\n \"woman_construction_worker_light_skin_tone\": \"👷🏻‍♀\",\n \"woman_construction_worker_medium-dark_skin_tone\": \"👷🏾‍♀\",\n \"woman_construction_worker_medium-light_skin_tone\": \"👷🏼‍♀\",\n \"woman_construction_worker_medium_skin_tone\": \"👷🏽‍♀\",\n \"woman_cook\": \"👩‍🍳\",\n \"woman_cook_dark_skin_tone\": \"👩🏿‍🍳\",\n \"woman_cook_light_skin_tone\": \"👩🏻‍🍳\",\n \"woman_cook_medium-dark_skin_tone\": \"👩🏾‍🍳\",\n \"woman_cook_medium-light_skin_tone\": \"👩🏼‍🍳\",\n \"woman_cook_medium_skin_tone\": \"👩🏽‍🍳\",\n \"woman_curly_hair\": \"👩‍🦱\",\n \"woman_dancing\": \"💃\",\n \"woman_dancing_dark_skin_tone\": \"💃🏿\",\n \"woman_dancing_light_skin_tone\": \"💃🏻\",\n \"woman_dancing_medium-dark_skin_tone\": \"💃🏾\",\n \"woman_dancing_medium-light_skin_tone\": \"💃🏼\",\n \"woman_dancing_medium_skin_tone\": \"💃🏽\",\n \"woman_dark_skin_tone\": \"👩🏿\",\n \"woman_dark_skin_tone_bald\": \"👩🏿‍🦲\",\n \"woman_dark_skin_tone_beard\": \"🧔🏿‍♀\",\n \"woman_dark_skin_tone_blond_hair\": \"👱🏿‍♀\",\n \"woman_dark_skin_tone_curly_hair\": \"👩🏿‍🦱\",\n \"woman_dark_skin_tone_red_hair\": \"👩🏿‍🦰\",\n \"woman_dark_skin_tone_white_hair\": \"👩🏿‍🦳\",\n \"woman_detective\": \"🕵‍♀\",\n \"woman_detective_dark_skin_tone\": \"🕵🏿‍♀\",\n \"woman_detective_light_skin_tone\": \"🕵🏻‍♀\",\n \"woman_detective_medium-dark_skin_tone\": \"🕵🏾‍♀\",\n \"woman_detective_medium-light_skin_tone\": \"🕵🏼‍♀\",\n \"woman_detective_medium_skin_tone\": \"🕵🏽‍♀\",\n \"woman_elf\": \"🧝‍♀\",\n \"woman_elf_dark_skin_tone\": \"🧝🏿‍♀\",\n \"woman_elf_light_skin_tone\": \"🧝🏻‍♀\",\n \"woman_elf_medium-dark_skin_tone\": \"🧝🏾‍♀\",\n \"woman_elf_medium-light_skin_tone\": \"🧝🏼‍♀\",\n \"woman_elf_medium_skin_tone\": \"🧝🏽‍♀\",\n \"woman_facepalming\": \"🤦‍♀\",\n \"woman_facepalming_dark_skin_tone\": \"🤦🏿‍♀\",\n \"woman_facepalming_light_skin_tone\": \"🤦🏻‍♀\",\n \"woman_facepalming_medium-dark_skin_tone\": \"🤦🏾‍♀\",\n \"woman_facepalming_medium-light_skin_tone\": \"🤦🏼‍♀\",\n \"woman_facepalming_medium_skin_tone\": \"🤦🏽‍♀\",\n \"woman_factory_worker\": \"👩‍🏭\",\n \"woman_factory_worker_dark_skin_tone\": \"👩🏿‍🏭\",\n \"woman_factory_worker_light_skin_tone\": \"👩🏻‍🏭\",\n \"woman_factory_worker_medium-dark_skin_tone\": \"👩🏾‍🏭\",\n \"woman_factory_worker_medium-light_skin_tone\": \"👩🏼‍🏭\",\n \"woman_factory_worker_medium_skin_tone\": \"👩🏽‍🏭\",\n \"woman_fairy\": \"🧚‍♀\",\n \"woman_fairy_dark_skin_tone\": \"🧚🏿‍♀\",\n \"woman_fairy_light_skin_tone\": \"🧚🏻‍♀\",\n \"woman_fairy_medium-dark_skin_tone\": \"🧚🏾‍♀\",\n \"woman_fairy_medium-light_skin_tone\": \"🧚🏼‍♀\",\n \"woman_fairy_medium_skin_tone\": \"🧚🏽‍♀\",\n \"woman_farmer\": \"👩‍🌾\",\n \"woman_farmer_dark_skin_tone\": \"👩🏿‍🌾\",\n \"woman_farmer_light_skin_tone\": \"👩🏻‍🌾\",\n \"woman_farmer_medium-dark_skin_tone\": \"👩🏾‍🌾\",\n \"woman_farmer_medium-light_skin_tone\": \"👩🏼‍🌾\",\n \"woman_farmer_medium_skin_tone\": \"👩🏽‍🌾\",\n \"woman_feeding_baby\": \"👩‍🍼\",\n \"woman_feeding_baby_dark_skin_tone\": \"👩🏿‍🍼\",\n \"woman_feeding_baby_light_skin_tone\": \"👩🏻‍🍼\",\n \"woman_feeding_baby_medium-dark_skin_tone\": \"👩🏾‍🍼\",\n \"woman_feeding_baby_medium-light_skin_tone\": \"👩🏼‍🍼\",\n \"woman_feeding_baby_medium_skin_tone\": \"👩🏽‍🍼\",\n \"woman_firefighter\": \"👩‍🚒\",\n \"woman_firefighter_dark_skin_tone\": \"👩🏿‍🚒\",\n \"woman_firefighter_light_skin_tone\": \"👩🏻‍🚒\",\n \"woman_firefighter_medium-dark_skin_tone\": \"👩🏾‍🚒\",\n \"woman_firefighter_medium-light_skin_tone\": \"👩🏼‍🚒\",\n \"woman_firefighter_medium_skin_tone\": \"👩🏽‍🚒\",\n \"woman_frowning\": \"🙍‍♀\",\n \"woman_frowning_dark_skin_tone\": \"🙍🏿‍♀\",\n \"woman_frowning_light_skin_tone\": \"🙍🏻‍♀\",\n \"woman_frowning_medium-dark_skin_tone\": \"🙍🏾‍♀\",\n \"woman_frowning_medium-light_skin_tone\": \"🙍🏼‍♀\",\n \"woman_frowning_medium_skin_tone\": \"🙍🏽‍♀\",\n \"woman_genie\": \"🧞‍♀\",\n \"woman_gesturing_NO\": \"🙅‍♀\",\n \"woman_gesturing_NO_dark_skin_tone\": \"🙅🏿‍♀\",\n \"woman_gesturing_NO_light_skin_tone\": \"🙅🏻‍♀\",\n \"woman_gesturing_NO_medium-dark_skin_tone\": \"🙅🏾‍♀\",\n \"woman_gesturing_NO_medium-light_skin_tone\": \"🙅🏼‍♀\",\n \"woman_gesturing_NO_medium_skin_tone\": \"🙅🏽‍♀\",\n \"woman_gesturing_OK\": \"🙆‍♀\",\n \"woman_gesturing_OK_dark_skin_tone\": \"🙆🏿‍♀\",\n \"woman_gesturing_OK_light_skin_tone\": \"🙆🏻‍♀\",\n \"woman_gesturing_OK_medium-dark_skin_tone\": \"🙆🏾‍♀\",\n \"woman_gesturing_OK_medium-light_skin_tone\": \"🙆🏼‍♀\",\n \"woman_gesturing_OK_medium_skin_tone\": \"🙆🏽‍♀\",\n \"woman_getting_haircut\": \"💇‍♀\",\n \"woman_getting_haircut_dark_skin_tone\": \"💇🏿‍♀\",\n \"woman_getting_haircut_light_skin_tone\": \"💇🏻‍♀\",\n \"woman_getting_haircut_medium-dark_skin_tone\": \"💇🏾‍♀\",\n \"woman_getting_haircut_medium-light_skin_tone\": \"💇🏼‍♀\",\n \"woman_getting_haircut_medium_skin_tone\": \"💇🏽‍♀\",\n \"woman_getting_massage\": \"💆‍♀\",\n \"woman_getting_massage_dark_skin_tone\": \"💆🏿‍♀\",\n \"woman_getting_massage_light_skin_tone\": \"💆🏻‍♀\",\n \"woman_getting_massage_medium-dark_skin_tone\": \"💆🏾‍♀\",\n \"woman_getting_massage_medium-light_skin_tone\": \"💆🏼‍♀\",\n \"woman_getting_massage_medium_skin_tone\": \"💆🏽‍♀\",\n \"woman_golfing\": \"🏌‍♀\",\n \"woman_golfing_dark_skin_tone\": \"🏌🏿‍♀\",\n \"woman_golfing_light_skin_tone\": \"🏌🏻‍♀\",\n \"woman_golfing_medium-dark_skin_tone\": \"🏌🏾‍♀\",\n \"woman_golfing_medium-light_skin_tone\": \"🏌🏼‍♀\",\n \"woman_golfing_medium_skin_tone\": \"🏌🏽‍♀\",\n \"woman_guard\": \"💂‍♀\",\n \"woman_guard_dark_skin_tone\": \"💂🏿‍♀\",\n \"woman_guard_light_skin_tone\": \"💂🏻‍♀\",\n \"woman_guard_medium-dark_skin_tone\": \"💂🏾‍♀\",\n \"woman_guard_medium-light_skin_tone\": \"💂🏼‍♀\",\n \"woman_guard_medium_skin_tone\": \"💂🏽‍♀\",\n \"woman_health_worker\": \"👩‍⚕\",\n \"woman_health_worker_dark_skin_tone\": \"👩🏿‍⚕\",\n \"woman_health_worker_light_skin_tone\": \"👩🏻‍⚕\",\n \"woman_health_worker_medium-dark_skin_tone\": \"👩🏾‍⚕\",\n \"woman_health_worker_medium-light_skin_tone\": \"👩🏼‍⚕\",\n \"woman_health_worker_medium_skin_tone\": \"👩🏽‍⚕\",\n \"woman_in_lotus_position\": \"🧘‍♀\",\n \"woman_in_lotus_position_dark_skin_tone\": \"🧘🏿‍♀\",\n \"woman_in_lotus_position_light_skin_tone\": \"🧘🏻‍♀\",\n \"woman_in_lotus_position_medium-dark_skin_tone\": \"🧘🏾‍♀\",\n \"woman_in_lotus_position_medium-light_skin_tone\": \"🧘🏼‍♀\",\n \"woman_in_lotus_position_medium_skin_tone\": \"🧘🏽‍♀\",\n \"woman_in_manual_wheelchair\": \"👩‍🦽\",\n \"woman_in_manual_wheelchair_dark_skin_tone\": \"👩🏿‍🦽\",\n \"woman_in_manual_wheelchair_light_skin_tone\": \"👩🏻‍🦽\",\n \"woman_in_manual_wheelchair_medium-dark_skin_tone\": \"👩🏾‍🦽\",\n \"woman_in_manual_wheelchair_medium-light_skin_tone\": \"👩🏼‍🦽\",\n \"woman_in_manual_wheelchair_medium_skin_tone\": \"👩🏽‍🦽\",\n \"woman_in_motorized_wheelchair\": \"👩‍🦼\",\n \"woman_in_motorized_wheelchair_dark_skin_tone\": \"👩🏿‍🦼\",\n \"woman_in_motorized_wheelchair_light_skin_tone\": \"👩🏻‍🦼\",\n \"woman_in_motorized_wheelchair_medium-dark_skin_tone\": \"👩🏾‍🦼\",\n \"woman_in_motorized_wheelchair_medium-light_skin_tone\": \"👩🏼‍🦼\",\n \"woman_in_motorized_wheelchair_medium_skin_tone\": \"👩🏽‍🦼\",\n \"woman_in_steamy_room\": \"🧖‍♀\",\n \"woman_in_steamy_room_dark_skin_tone\": \"🧖🏿‍♀\",\n \"woman_in_steamy_room_light_skin_tone\": \"🧖🏻‍♀\",\n \"woman_in_steamy_room_medium-dark_skin_tone\": \"🧖🏾‍♀\",\n \"woman_in_steamy_room_medium-light_skin_tone\": \"🧖🏼‍♀\",\n \"woman_in_steamy_room_medium_skin_tone\": \"🧖🏽‍♀\",\n \"woman_in_tuxedo\": \"🤵‍♀\",\n \"woman_in_tuxedo_dark_skin_tone\": \"🤵🏿‍♀\",\n \"woman_in_tuxedo_light_skin_tone\": \"🤵🏻‍♀\",\n \"woman_in_tuxedo_medium-dark_skin_tone\": \"🤵🏾‍♀\",\n \"woman_in_tuxedo_medium-light_skin_tone\": \"🤵🏼‍♀\",\n \"woman_in_tuxedo_medium_skin_tone\": \"🤵🏽‍♀\",\n \"woman_judge\": \"👩‍⚖\",\n \"woman_judge_dark_skin_tone\": \"👩🏿‍⚖\",\n \"woman_judge_light_skin_tone\": \"👩🏻‍⚖\",\n \"woman_judge_medium-dark_skin_tone\": \"👩🏾‍⚖\",\n \"woman_judge_medium-light_skin_tone\": \"👩🏼‍⚖\",\n \"woman_judge_medium_skin_tone\": \"👩🏽‍⚖\",\n \"woman_juggling\": \"🤹‍♀\",\n \"woman_juggling_dark_skin_tone\": \"🤹🏿‍♀\",\n \"woman_juggling_light_skin_tone\": \"🤹🏻‍♀\",\n \"woman_juggling_medium-dark_skin_tone\": \"🤹🏾‍♀\",\n \"woman_juggling_medium-light_skin_tone\": \"🤹🏼‍♀\",\n \"woman_juggling_medium_skin_tone\": \"🤹🏽‍♀\",\n \"woman_kneeling\": \"🧎‍♀\",\n \"woman_kneeling_dark_skin_tone\": \"🧎🏿‍♀\",\n \"woman_kneeling_light_skin_tone\": \"🧎🏻‍♀\",\n \"woman_kneeling_medium-dark_skin_tone\": \"🧎🏾‍♀\",\n \"woman_kneeling_medium-light_skin_tone\": \"🧎🏼‍♀\",\n \"woman_kneeling_medium_skin_tone\": \"🧎🏽‍♀\",\n \"woman_lifting_weights\": \"🏋‍♀\",\n \"woman_lifting_weights_dark_skin_tone\": \"🏋🏿‍♀\",\n \"woman_lifting_weights_light_skin_tone\": \"🏋🏻‍♀\",\n \"woman_lifting_weights_medium-dark_skin_tone\": \"🏋🏾‍♀\",\n \"woman_lifting_weights_medium-light_skin_tone\": \"🏋🏼‍♀\",\n \"woman_lifting_weights_medium_skin_tone\": \"🏋🏽‍♀\",\n \"woman_light_skin_tone\": \"👩🏻\",\n \"woman_light_skin_tone_bald\": \"👩🏻‍🦲\",\n \"woman_light_skin_tone_beard\": \"🧔🏻‍♀\",\n \"woman_light_skin_tone_blond_hair\": \"👱🏻‍♀\",\n \"woman_light_skin_tone_curly_hair\": \"👩🏻‍🦱\",\n \"woman_light_skin_tone_red_hair\": \"👩🏻‍🦰\",\n \"woman_light_skin_tone_white_hair\": \"👩🏻‍🦳\",\n \"woman_mage\": \"🧙‍♀\",\n \"woman_mage_dark_skin_tone\": \"🧙🏿‍♀\",\n \"woman_mage_light_skin_tone\": \"🧙🏻‍♀\",\n \"woman_mage_medium-dark_skin_tone\": \"🧙🏾‍♀\",\n \"woman_mage_medium-light_skin_tone\": \"🧙🏼‍♀\",\n \"woman_mage_medium_skin_tone\": \"🧙🏽‍♀\",\n \"woman_mechanic\": \"👩‍🔧\",\n \"woman_mechanic_dark_skin_tone\": \"👩🏿‍🔧\",\n \"woman_mechanic_light_skin_tone\": \"👩🏻‍🔧\",\n \"woman_mechanic_medium-dark_skin_tone\": \"👩🏾‍🔧\",\n \"woman_mechanic_medium-light_skin_tone\": \"👩🏼‍🔧\",\n \"woman_mechanic_medium_skin_tone\": \"👩🏽‍🔧\",\n \"woman_medium-dark_skin_tone\": \"👩🏾\",\n \"woman_medium-dark_skin_tone_bald\": \"👩🏾‍🦲\",\n \"woman_medium-dark_skin_tone_beard\": \"🧔🏾‍♀\",\n \"woman_medium-dark_skin_tone_blond_hair\": \"👱🏾‍♀\",\n \"woman_medium-dark_skin_tone_curly_hair\": \"👩🏾‍🦱\",\n \"woman_medium-dark_skin_tone_red_hair\": \"👩🏾‍🦰\",\n \"woman_medium-dark_skin_tone_white_hair\": \"👩🏾‍🦳\",\n \"woman_medium-light_skin_tone\": \"👩🏼\",\n \"woman_medium-light_skin_tone_bald\": \"👩🏼‍🦲\",\n \"woman_medium-light_skin_tone_beard\": \"🧔🏼‍♀\",\n \"woman_medium-light_skin_tone_blond_hair\": \"👱🏼‍♀\",\n \"woman_medium-light_skin_tone_curly_hair\": \"👩🏼‍🦱\",\n \"woman_medium-light_skin_tone_red_hair\": \"👩🏼‍🦰\",\n \"woman_medium-light_skin_tone_white_hair\": \"👩🏼‍🦳\",\n \"woman_medium_skin_tone\": \"👩🏽\",\n \"woman_medium_skin_tone_bald\": \"👩🏽‍🦲\",\n \"woman_medium_skin_tone_beard\": \"🧔🏽‍♀\",\n \"woman_medium_skin_tone_blond_hair\": \"👱🏽‍♀\",\n \"woman_medium_skin_tone_curly_hair\": \"👩🏽‍🦱\",\n \"woman_medium_skin_tone_red_hair\": \"👩🏽‍🦰\",\n \"woman_medium_skin_tone_white_hair\": \"👩🏽‍🦳\",\n \"woman_mountain_biking\": \"🚵‍♀\",\n \"woman_mountain_biking_dark_skin_tone\": \"🚵🏿‍♀\",\n \"woman_mountain_biking_light_skin_tone\": \"🚵🏻‍♀\",\n \"woman_mountain_biking_medium-dark_skin_tone\": \"🚵🏾‍♀\",\n \"woman_mountain_biking_medium-light_skin_tone\": \"🚵🏼‍♀\",\n \"woman_mountain_biking_medium_skin_tone\": \"🚵🏽‍♀\",\n \"woman_office_worker\": \"👩‍💼\",\n \"woman_office_worker_dark_skin_tone\": \"👩🏿‍💼\",\n \"woman_office_worker_light_skin_tone\": \"👩🏻‍💼\",\n \"woman_office_worker_medium-dark_skin_tone\": \"👩🏾‍💼\",\n \"woman_office_worker_medium-light_skin_tone\": \"👩🏼‍💼\",\n \"woman_office_worker_medium_skin_tone\": \"👩🏽‍💼\",\n \"woman_pilot\": \"👩‍✈\",\n \"woman_pilot_dark_skin_tone\": \"👩🏿‍✈\",\n \"woman_pilot_light_skin_tone\": \"👩🏻‍✈\",\n \"woman_pilot_medium-dark_skin_tone\": \"👩🏾‍✈\",\n \"woman_pilot_medium-light_skin_tone\": \"👩🏼‍✈\",\n \"woman_pilot_medium_skin_tone\": \"👩🏽‍✈\",\n \"woman_playing_handball\": \"🤾‍♀\",\n \"woman_playing_handball_dark_skin_tone\": \"🤾🏿‍♀\",\n \"woman_playing_handball_light_skin_tone\": \"🤾🏻‍♀\",\n \"woman_playing_handball_medium-dark_skin_tone\": \"🤾🏾‍♀\",\n \"woman_playing_handball_medium-light_skin_tone\": \"🤾🏼‍♀\",\n \"woman_playing_handball_medium_skin_tone\": \"🤾🏽‍♀\",\n \"woman_playing_water_polo\": \"🤽‍♀\",\n \"woman_playing_water_polo_dark_skin_tone\": \"🤽🏿‍♀\",\n \"woman_playing_water_polo_light_skin_tone\": \"🤽🏻‍♀\",\n \"woman_playing_water_polo_medium-dark_skin_tone\": \"🤽🏾‍♀\",\n \"woman_playing_water_polo_medium-light_skin_tone\": \"🤽🏼‍♀\",\n \"woman_playing_water_polo_medium_skin_tone\": \"🤽🏽‍♀\",\n \"woman_police_officer\": \"👮‍♀\",\n \"woman_police_officer_dark_skin_tone\": \"👮🏿‍♀\",\n \"woman_police_officer_light_skin_tone\": \"👮🏻‍♀\",\n \"woman_police_officer_medium-dark_skin_tone\": \"👮🏾‍♀\",\n \"woman_police_officer_medium-light_skin_tone\": \"👮🏼‍♀\",\n \"woman_police_officer_medium_skin_tone\": \"👮🏽‍♀\",\n \"woman_pouting\": \"🙎‍♀\",\n \"woman_pouting_dark_skin_tone\": \"🙎🏿‍♀\",\n \"woman_pouting_light_skin_tone\": \"🙎🏻‍♀\",\n \"woman_pouting_medium-dark_skin_tone\": \"🙎🏾‍♀\",\n \"woman_pouting_medium-light_skin_tone\": \"🙎🏼‍♀\",\n \"woman_pouting_medium_skin_tone\": \"🙎🏽‍♀\",\n \"woman_raising_hand\": \"🙋‍♀\",\n \"woman_raising_hand_dark_skin_tone\": \"🙋🏿‍♀\",\n \"woman_raising_hand_light_skin_tone\": \"🙋🏻‍♀\",\n \"woman_raising_hand_medium-dark_skin_tone\": \"🙋🏾‍♀\",\n \"woman_raising_hand_medium-light_skin_tone\": \"🙋🏼‍♀\",\n \"woman_raising_hand_medium_skin_tone\": \"🙋🏽‍♀\",\n \"woman_red_hair\": \"👩‍🦰\",\n \"woman_rowing_boat\": \"🚣‍♀\",\n \"woman_rowing_boat_dark_skin_tone\": \"🚣🏿‍♀\",\n \"woman_rowing_boat_light_skin_tone\": \"🚣🏻‍♀\",\n \"woman_rowing_boat_medium-dark_skin_tone\": \"🚣🏾‍♀\",\n \"woman_rowing_boat_medium-light_skin_tone\": \"🚣🏼‍♀\",\n \"woman_rowing_boat_medium_skin_tone\": \"🚣🏽‍♀\",\n \"woman_running\": \"🏃‍♀\",\n \"woman_running_dark_skin_tone\": \"🏃🏿‍♀\",\n \"woman_running_light_skin_tone\": \"🏃🏻‍♀\",\n \"woman_running_medium-dark_skin_tone\": \"🏃🏾‍♀\",\n \"woman_running_medium-light_skin_tone\": \"🏃🏼‍♀\",\n \"woman_running_medium_skin_tone\": \"🏃🏽‍♀\",\n \"woman_scientist\": \"👩‍🔬\",\n \"woman_scientist_dark_skin_tone\": \"👩🏿‍🔬\",\n \"woman_scientist_light_skin_tone\": \"👩🏻‍🔬\",\n \"woman_scientist_medium-dark_skin_tone\": \"👩🏾‍🔬\",\n \"woman_scientist_medium-light_skin_tone\": \"👩🏼‍🔬\",\n \"woman_scientist_medium_skin_tone\": \"👩🏽‍🔬\",\n \"woman_shrugging\": \"🤷‍♀\",\n \"woman_shrugging_dark_skin_tone\": \"🤷🏿‍♀\",\n \"woman_shrugging_light_skin_tone\": \"🤷🏻‍♀\",\n \"woman_shrugging_medium-dark_skin_tone\": \"🤷🏾‍♀\",\n \"woman_shrugging_medium-light_skin_tone\": \"🤷🏼‍♀\",\n \"woman_shrugging_medium_skin_tone\": \"🤷🏽‍♀\",\n \"woman_singer\": \"👩‍🎤\",\n \"woman_singer_dark_skin_tone\": \"👩🏿‍🎤\",\n \"woman_singer_light_skin_tone\": \"👩🏻‍🎤\",\n \"woman_singer_medium-dark_skin_tone\": \"👩🏾‍🎤\",\n \"woman_singer_medium-light_skin_tone\": \"👩🏼‍🎤\",\n \"woman_singer_medium_skin_tone\": \"👩🏽‍🎤\",\n \"woman_standing\": \"🧍‍♀\",\n \"woman_standing_dark_skin_tone\": \"🧍🏿‍♀\",\n \"woman_standing_light_skin_tone\": \"🧍🏻‍♀\",\n \"woman_standing_medium-dark_skin_tone\": \"🧍🏾‍♀\",\n \"woman_standing_medium-light_skin_tone\": \"🧍🏼‍♀\",\n \"woman_standing_medium_skin_tone\": \"🧍🏽‍♀\",\n \"woman_student\": \"👩‍🎓\",\n \"woman_student_dark_skin_tone\": \"👩🏿‍🎓\",\n \"woman_student_light_skin_tone\": \"👩🏻‍🎓\",\n \"woman_student_medium-dark_skin_tone\": \"👩🏾‍🎓\",\n \"woman_student_medium-light_skin_tone\": \"👩🏼‍🎓\",\n \"woman_student_medium_skin_tone\": \"👩🏽‍🎓\",\n \"woman_superhero\": \"🦸‍♀\",\n \"woman_superhero_dark_skin_tone\": \"🦸🏿‍♀\",\n \"woman_superhero_light_skin_tone\": \"🦸🏻‍♀\",\n \"woman_superhero_medium-dark_skin_tone\": \"🦸🏾‍♀\",\n \"woman_superhero_medium-light_skin_tone\": \"🦸🏼‍♀\",\n \"woman_superhero_medium_skin_tone\": \"🦸🏽‍♀\",\n \"woman_supervillain\": \"🦹‍♀\",\n \"woman_supervillain_dark_skin_tone\": \"🦹🏿‍♀\",\n \"woman_supervillain_light_skin_tone\": \"🦹🏻‍♀\",\n \"woman_supervillain_medium-dark_skin_tone\": \"🦹🏾‍♀\",\n \"woman_supervillain_medium-light_skin_tone\": \"🦹🏼‍♀\",\n \"woman_supervillain_medium_skin_tone\": \"🦹🏽‍♀\",\n \"woman_surfing\": \"🏄‍♀\",\n \"woman_surfing_dark_skin_tone\": \"🏄🏿‍♀\",\n \"woman_surfing_light_skin_tone\": \"🏄🏻‍♀\",\n \"woman_surfing_medium-dark_skin_tone\": \"🏄🏾‍♀\",\n \"woman_surfing_medium-light_skin_tone\": \"🏄🏼‍♀\",\n \"woman_surfing_medium_skin_tone\": \"🏄🏽‍♀\",\n \"woman_swimming\": \"🏊‍♀\",\n \"woman_swimming_dark_skin_tone\": \"🏊🏿‍♀\",\n \"woman_swimming_light_skin_tone\": \"🏊🏻‍♀\",\n \"woman_swimming_medium-dark_skin_tone\": \"🏊🏾‍♀\",\n \"woman_swimming_medium-light_skin_tone\": \"🏊🏼‍♀\",\n \"woman_swimming_medium_skin_tone\": \"🏊🏽‍♀\",\n \"woman_teacher\": \"👩‍🏫\",\n \"woman_teacher_dark_skin_tone\": \"👩🏿‍🏫\",\n \"woman_teacher_light_skin_tone\": \"👩🏻‍🏫\",\n \"woman_teacher_medium-dark_skin_tone\": \"👩🏾‍🏫\",\n \"woman_teacher_medium-light_skin_tone\": \"👩🏼‍🏫\",\n \"woman_teacher_medium_skin_tone\": \"👩🏽‍🏫\",\n \"woman_technologist\": \"👩‍💻\",\n \"woman_technologist_dark_skin_tone\": \"👩🏿‍💻\",\n \"woman_technologist_light_skin_tone\": \"👩🏻‍💻\",\n \"woman_technologist_medium-dark_skin_tone\": \"👩🏾‍💻\",\n \"woman_technologist_medium-light_skin_tone\": \"👩🏼‍💻\",\n \"woman_technologist_medium_skin_tone\": \"👩🏽‍💻\",\n \"woman_tipping_hand\": \"💁‍♀\",\n \"woman_tipping_hand_dark_skin_tone\": \"💁🏿‍♀\",\n \"woman_tipping_hand_light_skin_tone\": \"💁🏻‍♀\",\n \"woman_tipping_hand_medium-dark_skin_tone\": \"💁🏾‍♀\",\n \"woman_tipping_hand_medium-light_skin_tone\": \"💁🏼‍♀\",\n \"woman_tipping_hand_medium_skin_tone\": \"💁🏽‍♀\",\n \"woman_vampire\": \"🧛‍♀\",\n \"woman_vampire_dark_skin_tone\": \"🧛🏿‍♀\",\n \"woman_vampire_light_skin_tone\": \"🧛🏻‍♀\",\n \"woman_vampire_medium-dark_skin_tone\": \"🧛🏾‍♀\",\n \"woman_vampire_medium-light_skin_tone\": \"🧛🏼‍♀\",\n \"woman_vampire_medium_skin_tone\": \"🧛🏽‍♀\",\n \"woman_walking\": \"🚶‍♀\",\n \"woman_walking_dark_skin_tone\": \"🚶🏿‍♀\",\n \"woman_walking_light_skin_tone\": \"🚶🏻‍♀\",\n \"woman_walking_medium-dark_skin_tone\": \"🚶🏾‍♀\",\n \"woman_walking_medium-light_skin_tone\": \"🚶🏼‍♀\",\n \"woman_walking_medium_skin_tone\": \"🚶🏽‍♀\",\n \"woman_wearing_turban\": \"👳‍♀\",\n \"woman_wearing_turban_dark_skin_tone\": \"👳🏿‍♀\",\n \"woman_wearing_turban_light_skin_tone\": \"👳🏻‍♀\",\n \"woman_wearing_turban_medium-dark_skin_tone\": \"👳🏾‍♀\",\n \"woman_wearing_turban_medium-light_skin_tone\": \"👳🏼‍♀\",\n \"woman_wearing_turban_medium_skin_tone\": \"👳🏽‍♀\",\n \"woman_white_hair\": \"👩‍🦳\",\n \"woman_with_headscarf\": \"🧕\",\n \"woman_with_headscarf_dark_skin_tone\": \"🧕🏿\",\n \"woman_with_headscarf_light_skin_tone\": \"🧕🏻\",\n \"woman_with_headscarf_medium-dark_skin_tone\": \"🧕🏾\",\n \"woman_with_headscarf_medium-light_skin_tone\": \"🧕🏼\",\n \"woman_with_headscarf_medium_skin_tone\": \"🧕🏽\",\n \"woman_with_veil\": \"👰‍♀\",\n \"woman_with_veil_dark_skin_tone\": \"👰🏿‍♀\",\n \"woman_with_veil_light_skin_tone\": \"👰🏻‍♀\",\n \"woman_with_veil_medium-dark_skin_tone\": \"👰🏾‍♀\",\n \"woman_with_veil_medium-light_skin_tone\": \"👰🏼‍♀\",\n \"woman_with_veil_medium_skin_tone\": \"👰🏽‍♀\",\n \"woman_with_white_cane\": \"👩‍🦯\",\n \"woman_with_white_cane_dark_skin_tone\": \"👩🏿‍🦯\",\n \"woman_with_white_cane_light_skin_tone\": \"👩🏻‍🦯\",\n \"woman_with_white_cane_medium-dark_skin_tone\": \"👩🏾‍🦯\",\n \"woman_with_white_cane_medium-light_skin_tone\": \"👩🏼‍🦯\",\n \"woman_with_white_cane_medium_skin_tone\": \"👩🏽‍🦯\",\n \"woman_zombie\": \"🧟‍♀\",\n \"woman’s_boot\": \"👢\",\n \"woman’s_clothes\": \"👚\",\n \"woman’s_hat\": \"👒\",\n \"woman’s_sandal\": \"👡\",\n \"women_holding_hands\": \"👭\",\n \"women_holding_hands_dark_skin_tone\": \"👭🏿\",\n \"women_holding_hands_dark_skin_tone_light_skin_tone\": \"👩🏿‍🤝‍👩🏻\",\n \"women_holding_hands_dark_skin_tone_medium-dark_skin_tone\": \"👩🏿‍🤝‍👩🏾\",\n \"women_holding_hands_dark_skin_tone_medium-light_skin_tone\": \"👩🏿‍🤝‍👩🏼\",\n \"women_holding_hands_dark_skin_tone_medium_skin_tone\": \"👩🏿‍🤝‍👩🏽\",\n \"women_holding_hands_light_skin_tone\": \"👭🏻\",\n \"women_holding_hands_light_skin_tone_dark_skin_tone\": \"👩🏻‍🤝‍👩🏿\",\n \"women_holding_hands_light_skin_tone_medium-dark_skin_tone\": \"👩🏻‍🤝‍👩🏾\",\n \"women_holding_hands_light_skin_tone_medium-light_skin_tone\": \"👩🏻‍🤝‍👩🏼\",\n \"women_holding_hands_light_skin_tone_medium_skin_tone\": \"👩🏻‍🤝‍👩🏽\",\n \"women_holding_hands_medium-dark_skin_tone\": \"👭🏾\",\n \"women_holding_hands_medium-dark_skin_tone_dark_skin_tone\": \"👩🏾‍🤝‍👩🏿\",\n \"women_holding_hands_medium-dark_skin_tone_light_skin_tone\": \"👩🏾‍🤝‍👩🏻\",\n (\n \"women_holding_hands_medium-dark_skin_tone_medium-light_skin_tone\"\n ): \"👩🏾‍🤝‍👩🏼\",\n \"women_holding_hands_medium-dark_skin_tone_medium_skin_tone\": \"👩🏾‍🤝‍👩🏽\",\n \"women_holding_hands_medium-light_skin_tone\": \"👭🏼\",\n \"women_holding_hands_medium-light_skin_tone_dark_skin_tone\": \"👩🏼‍🤝‍👩🏿\",\n \"women_holding_hands_medium-light_skin_tone_light_skin_tone\": \"👩🏼‍🤝‍👩🏻\",\n (\n \"women_holding_hands_medium-light_skin_tone_medium-dark_skin_tone\"\n ): \"👩🏼‍🤝‍👩🏾\",\n (\n \"women_holding_hands_medium-light_skin_tone_medium_skin_tone\"\n ): \"👩🏼‍🤝‍👩🏽\",\n \"women_holding_hands_medium_skin_tone\": \"👭🏽\",\n \"women_holding_hands_medium_skin_tone_dark_skin_tone\": \"👩🏽‍🤝‍👩🏿\",\n \"women_holding_hands_medium_skin_tone_light_skin_tone\": \"👩🏽‍🤝‍👩🏻\",\n \"women_holding_hands_medium_skin_tone_medium-dark_skin_tone\": \"👩🏽‍🤝‍👩🏾\",\n (\n \"women_holding_hands_medium_skin_tone_medium-light_skin_tone\"\n ): \"👩🏽‍🤝‍👩🏼\",\n \"women_with_bunny_ears\": \"👯‍♀\",\n \"women_wrestling\": \"🤼‍♀\",\n \"women’s_room\": \"🚺\",\n \"wood\": \"🪵\",\n \"woozy_face\": \"🥴\",\n \"flushed\": \"🥴\",\n \"world_map\": \"🗺\",\n \"worm\": \"🪱\",\n \"worried_face\": \"😟\",\n \"wrapped_gift\": \"🎁\",\n \"wrench\": \"🔧\",\n \"writing_hand\": \"✍\",\n \"writing_hand_dark_skin_tone\": \"✍🏿\",\n \"writing_hand_light_skin_tone\": \"✍🏻\",\n \"writing_hand_medium-dark_skin_tone\": \"✍🏾\",\n \"writing_hand_medium-light_skin_tone\": \"✍🏼\",\n \"writing_hand_medium_skin_tone\": \"✍🏽\",\n \"x-ray\": \"🩻\",\n \"yarn\": \"🧶\",\n \"yawning_face\": \"🥱\",\n \"yellow_circle\": \"🟡\",\n \"yellow_heart\": \"💛\",\n \"yellow_square\": \"🟨\",\n \"yen_banknote\": \"💴\",\n \"yin_yang\": \"☯\",\n \"yo-yo\": \"🪀\",\n \"zany_face\": \"🤪\",\n \"zebra\": \"🦓\",\n \"zipper-mouth_face\": \"🤐\",\n \"zombie\": \"🧟\",\n \"Åland_Islands\": \"🇦🇽\",\n}\n" }, { "path": "guide/content/en/guide/advanced/class-based-views.md", "content": "# Class Based Views\n\n## Why use them?\n\n.. column::\n\n ### The problem\n\n A common pattern when designing an API is to have multiple functionality on the same endpoint that depends upon the HTTP method.\n\n While both of these options work, they are not good design practices and may be hard to maintain over time as your project grows.\n\n.. column::\n\n ```python\n @app.get(\"/foo\")\n async def foo_get(request):\n ...\n\n @app.post(\"/foo\")\n async def foo_post(request):\n ...\n\n @app.put(\"/foo\")\n async def foo_put(request):\n ...\n\n @app.route(\"/bar\", methods=[\"GET\", \"POST\", \"PATCH\"])\n async def bar(request):\n if request.method == \"GET\":\n ...\n\n elif request.method == \"POST\":\n ...\n \n elif request.method == \"PATCH\":\n ...\n ```\n\n\n.. column::\n\n ### The solution\n\n Class-based views are simply classes that implement response behavior to requests. They provide a way to compartmentalize handling of different HTTP request types at the same endpoint.\n\n.. column::\n\n ```python\n from sanic.views import HTTPMethodView\n\n class FooBar(HTTPMethodView):\n async def get(self, request):\n ...\n \n async def post(self, request):\n ...\n \n async def put(self, request):\n ...\n\n app.add_route(FooBar.as_view(), \"/foobar\")\n ```\n\n## Defining a view\n\nA class-based view should subclass :class:`sanic.views.HTTPMethodView`. You can then implement class methods with the name of the corresponding HTTP method. If a request is received that has no defined method, a `405: Method not allowed` response will be generated.\n\n.. column::\n\n To register a class-based view on an endpoint, the `app.add_route` method is used. The first argument should be the defined class with the method `as_view` invoked, and the second should be the URL endpoint.\n\n The available methods are:\n\n - get\n - post\n - put\n - patch\n - delete\n - head\n - options\n\n.. column::\n\n ```python\n from sanic.views import HTTPMethodView\n from sanic.response import text\n\n class SimpleView(HTTPMethodView):\n\n def get(self, request):\n return text(\"I am get method\")\n\n # You can also use async syntax\n async def post(self, request):\n return text(\"I am post method\")\n\n def put(self, request):\n return text(\"I am put method\")\n\n def patch(self, request):\n return text(\"I am patch method\")\n\n def delete(self, request):\n return text(\"I am delete method\")\n\n app.add_route(SimpleView.as_view(), \"/\")\n ```\n\n## Path parameters\n\n\n.. column::\n\n You can use path parameters exactly as discussed in [the routing section](../basics/routing.md).\n\n.. column::\n\n ```python\n class NameView(HTTPMethodView):\n\n def get(self, request, name):\n return text(\"Hello {}\".format(name))\n\n app.add_route(NameView.as_view(), \"/\")\n ```\n\n## Decorators\n\nAs discussed in [the decorators section](../best-practices/decorators.md), often you will need to add functionality to endpoints with the use of decorators. You have two options with CBV:\n\n1. Apply to _all_ HTTP methods in the view\n2. Apply individually to HTTP methods in the view\n\nLet's see what the options look like:\n\n.. column::\n\n ### Apply to all methods\n\n If you want to add any decorators to the class, you can set the `decorators` class variable. These will be applied to the class when `as_view` is called.\n\n.. column::\n\n ```python\n class ViewWithDecorator(HTTPMethodView):\n decorators = [some_decorator_here]\n\n def get(self, request, name):\n return text(\"Hello I have a decorator\")\n\n def post(self, request, name):\n return text(\"Hello I also have a decorator\")\n\n app.add_route(ViewWithDecorator.as_view(), \"/url\")\n ```\n\n\n.. column::\n\n ### Apply to individual methods\n\n But if you just want to decorate some methods and not all methods, you can as shown here.\n\n.. column::\n\n ```python\n class ViewWithSomeDecorator(HTTPMethodView):\n\n @staticmethod\n @some_decorator_here\n def get(request, name):\n return text(\"Hello I have a decorator\")\n\n def post(self, request, name):\n return text(\"Hello I do not have any decorators\")\n\n @some_decorator_here\n def patch(self, request, name):\n return text(\"Hello I have a decorator\")\n ```\n\n## Generating a URL\n\n.. column::\n\n This works just like [generating any other URL](../basics/routing.md#generating-a-url), except that the class name is a part of the endpoint.\n\n.. column::\n\n ```python\n @app.route(\"/\")\n def index(request):\n url = app.url_for(\"SpecialClassView\")\n return redirect(url)\n\n class SpecialClassView(HTTPMethodView):\n def get(self, request):\n return text(\"Hello from the Special Class View!\")\n\n app.add_route(SpecialClassView.as_view(), \"/special_class_view\")\n ```\n\n" }, { "path": "guide/content/en/guide/advanced/commands.md", "content": "# Custom CLI Commands\n\nSanic ships with a [CLI](../running/running.md#running-via-command) for running the Sanic server. Sometimes, you may have the need to enhance that CLI to run your own custom commands. Commands are invoked using the following basic pattern:\n\n```sh\nsanic path.to:app exec [--arg=value]\n```\n\n.. column::\n\n To enable this, you can use your `Sanic` app instance to wrap functions that can be callable from the CLI using the `@app.command` decorator.\n\n.. column::\n\n ```python\n @app.command\n async def hello(name=\"world\"):\n print(f\"Hello, {name}.\")\n ```\n \n.. column::\n\n Now, you can easily invoke this command using the `exec` action. \n \n.. column::\n\n ```sh\n sanic path.to:app exec hello --name=Adam\n ```\n \nCommand handlers can be either synchronous or asynchronous. The handler can accept any number of keyword arguments, which will be passed in from the CLI.\n\n.. column::\n\n By default, the name of the function will be the command name. You can override this by passing the `name` argument to the decorator.\n \n.. column::\n\n ```python\n @app.command(name=\"greet\")\n async def hello(name=\"world\"):\n print(f\"Hello, {name}.\")\n ```\n \n ```sh\n sanic path.to:app exec greet --name=Adam\n ```\n\n.. warning::\n\n This feature is still in **BETA** and may change in future versions. There is no type coercion or validation on the arguments passed in from the CLI, and the CLI will ignore any return values from the command handler. Future enhancements and changes are likely.\n\n*Added in v24.12*\n" }, { "path": "guide/content/en/guide/advanced/proxy-headers.md", "content": "# Proxy configuration\n\nWhen you use a reverse proxy server (e.g. nginx), the value of `request.ip` will contain the IP of a proxy, typically `127.0.0.1`. Almost always, this is **not** what you will want.\n\nSanic may be configured to use proxy headers for determining the true client IP, available as `request.remote_addr`. The full external URL is also constructed from header fields _if available_.\n\n\n.. tip:: Heads up\n\n Without proper precautions, a malicious client may use proxy headers to spoof its own IP. To avoid such issues, Sanic does not use any proxy headers unless explicitly enabled.\n\n\n\n.. column::\n\n Services behind reverse proxies must configure one or more of the following [configuration values](../deployment/configuration.md):\n\n - `FORWARDED_SECRET`\n - `REAL_IP_HEADER`\n - `PROXIES_COUNT`\n\n.. column::\n\n ```python\n app.config.FORWARDED_SECRET = \"super-duper-secret\"\n app.config.REAL_IP_HEADER = \"CF-Connecting-IP\"\n app.config.PROXIES_COUNT = 2\n ```\n\n## Forwarded header\n\nIn order to use the `Forwarded` header, you should set `app.config.FORWARDED_SECRET` to a value known to the trusted proxy server. The secret is used to securely identify a specific proxy server.\n\nSanic ignores any elements without the secret key, and will not even parse the header if no secret is set.\n\nAll other proxy headers are ignored once a trusted forwarded element is found, as it already carries complete information about the client.\n\nTo learn more about the `Forwarded` header, read the related [MDN](https://developer.mozilla.org/en-US/docs/Web/HTTP/Headers/Forwarded) and [Nginx](https://www.nginx.com/resources/wiki/start/topics/examples/forwarded/) articles.\n\n## Traditional proxy headers\n\n### IP Headers\n\nWhen your proxy forwards you the IP address in a known header, you can tell Sanic what that is with the `REAL_IP_HEADER` config value.\n\n### X-Forwarded-For\n\nThis header typically contains a chain of IP addresses through each layer of a proxy. Setting `PROXIES_COUNT` tells Sanic how deep to look to get an actual IP address for the client. This value should equal the _expected_ number of IP addresses in the chain.\n\n### Other X-headers\n\nIf a client IP is found by one of these methods, Sanic uses the following headers for URL parts:\n\n- x-forwarded-proto\n- x-forwarded-host\n- x-forwarded-port\n- x-forwarded-path\n- x-scheme\n\n## Examples\n\nIn the following examples, all requests will assume that the endpoint looks like this:\n```python\n@app.route(\"/fwd\")\nasync def forwarded(request):\n return json(\n {\n \"remote_addr\": request.remote_addr,\n \"scheme\": request.scheme,\n \"server_name\": request.server_name,\n \"server_port\": request.server_port,\n \"forwarded\": request.forwarded,\n }\n )\n```\n\n---\n\n##### Example 1\n\nWithout configured FORWARDED_SECRET, x-headers should be respected\n\n```sh\ncurl localhost:8000/fwd \\\n\t-H 'Forwarded: for=1.1.1.1, for=injected;host=\", for=\"[::2]\";proto=https;host=me.tld;path=\"/app/\";secret=mySecret,for=broken;;secret=b0rked, for=127.0.0.3;scheme=http;port=1234' \\\n\t-H \"X-Real-IP: 127.0.0.2\" \\\n\t-H \"X-Forwarded-For: 127.0.1.1\" \\\n\t-H \"X-Scheme: ws\" \\\n\t-H \"Host: local.site\" | jq\n```\n\n.. column::\n\n ```python\n # Sanic application config\n app.config.PROXIES_COUNT = 1\n app.config.REAL_IP_HEADER = \"x-real-ip\"\n ```\n\n.. column::\n\n ```bash\n # curl response\n {\n \"remote_addr\": \"127.0.0.2\",\n \"scheme\": \"ws\",\n \"server_name\": \"local.site\",\n \"server_port\": 80,\n \"forwarded\": {\n \"for\": \"127.0.0.2\",\n \"proto\": \"ws\"\n }\n }\n ```\n\n---\n\n##### Example 2\n\nFORWARDED_SECRET now configured\n\n```sh\ncurl localhost:8000/fwd \\\n\t-H 'Forwarded: for=1.1.1.1, for=injected;host=\", for=\"[::2]\";proto=https;host=me.tld;path=\"/app/\";secret=mySecret,for=broken;;secret=b0rked, for=127.0.0.3;scheme=http;port=1234' \\\n\t-H \"X-Real-IP: 127.0.0.2\" \\\n\t-H \"X-Forwarded-For: 127.0.1.1\" \\\n\t-H \"X-Scheme: ws\" \\\n\t-H \"Host: local.site\" | jq\n```\n\n.. column::\n\n ```python\n # Sanic application config\n app.config.PROXIES_COUNT = 1\n app.config.REAL_IP_HEADER = \"x-real-ip\"\n app.config.FORWARDED_SECRET = \"mySecret\"\n ```\n\n.. column::\n\n ```bash\n # curl response\n {\n \"remote_addr\": \"[::2]\",\n \"scheme\": \"https\",\n \"server_name\": \"me.tld\",\n \"server_port\": 443,\n \"forwarded\": {\n \"for\": \"[::2]\",\n \"proto\": \"https\",\n \"host\": \"me.tld\",\n \"path\": \"/app/\",\n \"secret\": \"mySecret\"\n }\n }\n ```\n\n---\n\n##### Example 3\n\nEmpty Forwarded header -> use X-headers\n\n```sh\ncurl localhost:8000/fwd \\\n\t-H \"X-Real-IP: 127.0.0.2\" \\\n\t-H \"X-Forwarded-For: 127.0.1.1\" \\\n\t-H \"X-Scheme: ws\" \\\n\t-H \"Host: local.site\" | jq\n```\n\n.. column::\n\n ```python\n # Sanic application config\n app.config.PROXIES_COUNT = 1\n app.config.REAL_IP_HEADER = \"x-real-ip\"\n app.config.FORWARDED_SECRET = \"mySecret\"\n ```\n\n.. column::\n\n ```bash\n # curl response\n {\n \"remote_addr\": \"127.0.0.2\",\n \"scheme\": \"ws\",\n \"server_name\": \"local.site\",\n \"server_port\": 80,\n \"forwarded\": {\n \"for\": \"127.0.0.2\",\n \"proto\": \"ws\"\n }\n }\n ```\n\n---\n\n##### Example 4\n\nHeader present but not matching anything\n\n```sh\ncurl localhost:8000/fwd \\\n\t-H \"Forwarded: nomatch\" | jq\n```\n\n.. column::\n\n ```python\n # Sanic application config\n app.config.PROXIES_COUNT = 1\n app.config.REAL_IP_HEADER = \"x-real-ip\"\n app.config.FORWARDED_SECRET = \"mySecret\"\n ```\n\n.. column::\n\n ```bash\n # curl response\n {\n \"remote_addr\": \"\",\n \"scheme\": \"http\",\n \"server_name\": \"localhost\",\n \"server_port\": 8000,\n \"forwarded\": {}\n }\n\n ```\n\n---\n\n##### Example 5\n\nForwarded header present but no matching secret -> use X-headers\n\n```sh\ncurl localhost:8000/fwd \\\n\t-H \"Forwarded: for=1.1.1.1;secret=x, for=127.0.0.1\" \\\n\t-H \"X-Real-IP: 127.0.0.2\" | jq\n```\n\n.. column::\n\n ```python\n # Sanic application config\n app.config.PROXIES_COUNT = 1\n app.config.REAL_IP_HEADER = \"x-real-ip\"\n app.config.FORWARDED_SECRET = \"mySecret\"\n ```\n\n.. column::\n\n ```bash\n # curl response\n {\n \"remote_addr\": \"127.0.0.2\",\n \"scheme\": \"http\",\n \"server_name\": \"localhost\",\n \"server_port\": 8000,\n \"forwarded\": {\n \"for\": \"127.0.0.2\"\n }\n }\n ```\n\n---\n\n##### Example 6\n\nDifferent formatting and hitting both ends of the header\n\n```sh\ncurl localhost:8000/fwd \\\n\t-H 'Forwarded: Secret=\"mySecret\";For=127.0.0.4;Port=1234' | jq\n```\n\n.. column::\n\n ```python\n # Sanic application config\n app.config.PROXIES_COUNT = 1\n app.config.REAL_IP_HEADER = \"x-real-ip\"\n app.config.FORWARDED_SECRET = \"mySecret\"\n ```\n\n.. column::\n\n ```bash\n # curl response\n {\n \"remote_addr\": \"127.0.0.4\",\n \"scheme\": \"http\",\n \"server_name\": \"localhost\",\n \"server_port\": 1234,\n \"forwarded\": {\n \"secret\": \"mySecret\",\n \"for\": \"127.0.0.4\",\n \"port\": 1234\n }\n }\n ```\n\n---\n\n##### Example 7\n\nTest escapes (modify this if you see anyone implementing quoted-pairs)\n\n```sh\ncurl localhost:8000/fwd \\\n\t-H 'Forwarded: for=test;quoted=\"\\,x=x;y=\\\";secret=mySecret' | jq\n```\n\n.. column::\n\n ```python\n # Sanic application config\n app.config.PROXIES_COUNT = 1\n app.config.REAL_IP_HEADER = \"x-real-ip\"\n app.config.FORWARDED_SECRET = \"mySecret\"\n ```\n\n.. column::\n\n ```bash\n # curl response\n {\n \"remote_addr\": \"test\",\n \"scheme\": \"http\",\n \"server_name\": \"localhost\",\n \"server_port\": 8000,\n \"forwarded\": {\n \"for\": \"test\",\n \"quoted\": \"\\\\,x=x;y=\\\\\",\n \"secret\": \"mySecret\"\n }\n }\n ```\n\n---\n\n##### Example 8\n\nSecret insulated by malformed field #1\n\n```sh\ncurl localhost:8000/fwd \\\n\t-H 'Forwarded: for=test;secret=mySecret;b0rked;proto=wss;' | jq\n```\n\n.. column::\n\n ```python\n # Sanic application config\n app.config.PROXIES_COUNT = 1\n app.config.REAL_IP_HEADER = \"x-real-ip\"\n app.config.FORWARDED_SECRET = \"mySecret\"\n ```\n\n.. column::\n\n ```bash\n # curl response\n {\n \"remote_addr\": \"test\",\n \"scheme\": \"http\",\n \"server_name\": \"localhost\",\n \"server_port\": 8000,\n \"forwarded\": {\n \"for\": \"test\",\n \"secret\": \"mySecret\"\n }\n }\n ```\n\n---\n\n##### Example 9\n\nSecret insulated by malformed field #2\n\n```sh\ncurl localhost:8000/fwd \\\n\t-H 'Forwarded: for=test;b0rked;secret=mySecret;proto=wss' | jq\n```\n\n.. column::\n\n ```python\n # Sanic application config\n app.config.PROXIES_COUNT = 1\n app.config.REAL_IP_HEADER = \"x-real-ip\"\n app.config.FORWARDED_SECRET = \"mySecret\"\n ```\n\n.. column::\n\n ```bash\n # curl response\n {\n \"remote_addr\": \"\",\n \"scheme\": \"wss\",\n \"server_name\": \"localhost\",\n \"server_port\": 8000,\n \"forwarded\": {\n \"secret\": \"mySecret\",\n \"proto\": \"wss\"\n }\n }\n ```\n\n---\n\n##### Example 10\n\nUnexpected termination should not lose existing acceptable values\n\n```sh\ncurl localhost:8000/fwd \\\n\t-H 'Forwarded: b0rked;secret=mySecret;proto=wss' | jq\n```\n\n.. column::\n\n ```python\n # Sanic application config\n app.config.PROXIES_COUNT = 1\n app.config.REAL_IP_HEADER = \"x-real-ip\"\n app.config.FORWARDED_SECRET = \"mySecret\"\n ```\n\n.. column::\n\n ```bash\n # curl response\n {\n \"remote_addr\": \"\",\n \"scheme\": \"wss\",\n \"server_name\": \"localhost\",\n \"server_port\": 8000,\n \"forwarded\": {\n \"secret\": \"mySecret\",\n \"proto\": \"wss\"\n }\n }\n ```\n\n---\n\n##### Example 11\n\nField normalization\n\n```sh\ncurl localhost:8000/fwd \\\n\t-H 'Forwarded: PROTO=WSS;BY=\"CAFE::8000\";FOR=unknown;PORT=X;HOST=\"A:2\";PATH=\"/With%20Spaces%22Quoted%22/sanicApp?key=val\";SECRET=mySecret' | jq\n```\n\n.. column::\n\n ```python\n # Sanic application config\n app.config.PROXIES_COUNT = 1\n app.config.REAL_IP_HEADER = \"x-real-ip\"\n app.config.FORWARDED_SECRET = \"mySecret\"\n ```\n\n.. column::\n\n ```bash\n # curl response\n {\n \"remote_addr\": \"\",\n \"scheme\": \"wss\",\n \"server_name\": \"a\",\n \"server_port\": 2,\n \"forwarded\": {\n \"proto\": \"wss\",\n \"by\": \"[cafe::8000]\",\n \"host\": \"a:2\",\n \"path\": \"/With Spaces\\\"Quoted\\\"/sanicApp?key=val\",\n \"secret\": \"mySecret\"\n }\n }\n ```\n\n---\n\n##### Example 12\n\nUsing \"by\" field as secret\n\n```sh\ncurl localhost:8000/fwd \\\n\t-H 'Forwarded: for=1.2.3.4; by=_proxySecret' | jq\n```\n\n.. column::\n\n ```python\n # Sanic application config\n app.config.PROXIES_COUNT = 1\n app.config.REAL_IP_HEADER = \"x-real-ip\"\n app.config.FORWARDED_SECRET = \"_proxySecret\"\n ```\n\n.. column::\n\n ```bash\n # curl response\n {\n \"remote_addr\": \"1.2.3.4\",\n \"scheme\": \"http\",\n \"server_name\": \"localhost\",\n \"server_port\": 8000,\n \"forwarded\": {\n \"for\": \"1.2.3.4\",\n \"by\": \"_proxySecret\"\n }\n }\n\n ```\n\n" }, { "path": "guide/content/en/guide/advanced/signals.md", "content": "# Signals\n\nSignals provide a way for one part of your application to tell another part that something happened.\n\n```python\n@app.signal(\"user.registration.created\")\nasync def send_registration_email(**context):\n await send_email(context[\"email\"], template=\"registration\")\n\n@app.post(\"/register\")\nasync def handle_registration(request):\n await do_registration(request)\n await request.app.dispatch(\n \"user.registration.created\",\n context={\"email\": request.json.email}\n })\n```\n\n## Adding a signal\n\n.. column::\n\n The API for adding a signal is very similar to adding a route.\n\n.. column::\n\n ```python\n async def my_signal_handler():\n print(\"something happened\")\n\n app.add_signal(my_signal_handler, \"something.happened.ohmy\")\n ```\n\n\n.. column::\n\n But, perhaps a slightly more convenient method is to use the built-in decorators.\n\n.. column::\n\n ```python\n @app.signal(\"something.happened.ohmy\")\n async def my_signal_handler():\n print(\"something happened\")\n ```\n\n\n.. column::\n\n If the signal requires conditions, make sure to add them while adding the handler.\n\n.. column::\n\n ```python\n async def my_signal_handler1():\n print(\"something happened\")\n\n app.add_signal(\n my_signal_handler,\n \"something.happened.ohmy1\",\n conditions={\"some_condition\": \"value\"}\n )\n\n @app.signal(\"something.happened.ohmy2\", conditions={\"some_condition\": \"value\"})\n async def my_signal_handler2():\n print(\"something happened\")\n ```\n\n\n.. column::\n\n Signals can also be declared on blueprints\n\n.. column::\n\n ```python\n bp = Blueprint(\"foo\")\n\n @bp.signal(\"something.happened.ohmy\")\n async def my_signal_handler():\n print(\"something happened\")\n ```\n\n## Built-in signals\n\nIn addition to creating a new signal, there are a number of built-in signals that are dispatched from Sanic itself. These signals exist to provide developers with more opportunities to add functionality into the request and server lifecycles.\n\n*Added in v21.9*\n\n.. column::\n\n You can attach them just like any other signal to an application or blueprint instance.\n\n.. column::\n\n ```python\n @app.signal(\"http.lifecycle.complete\")\n async def my_signal_handler(conn_info):\n print(\"Connection has been closed\")\n ```\n\nThese signals are the signals that are available, along with the arguments that the handlers take, and the conditions that attach (if any).\n\n| Event name | Arguments | Conditions |\n| -------------------------- | ------------------------------- | --------------------------------------------------------- |\n| `http.routing.before` | request | |\n| `http.routing.after` | request, route, kwargs, handler | |\n| `http.handler.before` | request | |\n| `http.handler.after` | request | |\n| `http.lifecycle.begin` | conn_info | |\n| `http.lifecycle.read_head` | head | |\n| `http.lifecycle.request` | request | |\n| `http.lifecycle.handle` | request | |\n| `http.lifecycle.read_body` | body | |\n| `http.lifecycle.exception` | request, exception | |\n| `http.lifecycle.response` | request, response | |\n| `http.lifecycle.send` | data | |\n| `http.lifecycle.complete` | conn_info | |\n| `http.middleware.before` | request, response | `{\"attach_to\": \"request\"}` or `{\"attach_to\": \"response\"}` |\n| `http.middleware.after` | request, response | `{\"attach_to\": \"request\"}` or `{\"attach_to\": \"response\"}` |\n| `server.exception.report` | app, exception | |\n| `server.init.before` | app, loop | |\n| `server.init.after` | app, loop | |\n| `server.shutdown.before` | app, loop | |\n| `server.shutdown.after` | app, loop | |\n\nVersion 22.9 added `http.handler.before` and `http.handler.after`.\n\nVersion 23.6 added `server.exception.report`.\n\n.. column::\n\n To make using the built-in signals easier, there is an `Enum` object that contains all of the allowed built-ins. With a modern IDE this will help so that you do not need to remember the full list of event names as strings.\n\n *Added in v21.12*\n\n.. column::\n\n ```python\n from sanic.signals import Event\n\n @app.signal(Event.HTTP_LIFECYCLE_COMPLETE)\n async def my_signal_handler(conn_info):\n print(\"Connection has been closed\")\n ```\n\n## Events\n\n.. column::\n\n Signals are based off of an _event_. An event, is simply a string in the following pattern:\n\n.. column::\n\n ```\n namespace.reference.action\n ```\n\n\n\n.. tip:: Events must have three parts. If you do not know what to use, try these patterns:\n\n - `my_app.something.happened`\n - `sanic.notice.hello`\n\n\n### Event parameters\n\n.. column::\n\n An event can be \"dynamic\" and declared using the same syntax as [path parameters](../basics/routing.md#path-parameters). This allows matching based upon arbitrary values.\n\n.. column::\n\n ```python\n @app.signal(\"foo.bar.\")\n async def signal_handler(thing):\n print(f\"[signal_handler] {thing=}\")\n\n @app.get(\"/\")\n async def trigger(request):\n await app.dispatch(\"foo.bar.baz\")\n return response.text(\"Done.\")\n ```\n\nCheckout [path parameters](../basics/routing.md#path-parameters) for more information on allowed type definitions.\n\n\n.. info:: Only the third part of an event (the action) may be dynamic:\n\n - `foo.bar.` 🆗\n - `foo..baz` ❌\n\n\n### Waiting\n\n.. column::\n\n In addition to executing a signal handler, your application can wait for an event to be triggered.\n\n.. column::\n\n ```python\n await app.event(\"foo.bar.baz\")\n ```\n\n\n.. column::\n\n **IMPORTANT**: waiting is a blocking function. Therefore, you likely will want this to run in a [background task](../basics/tasks.md).\n\n.. column::\n\n ```python\n async def wait_for_event(app):\n while True:\n print(\"> waiting\")\n await app.event(\"foo.bar.baz\")\n print(\"> event found\\n\")\n\n @app.after_server_start\n async def after_server_start(app, loop):\n app.add_task(wait_for_event(app))\n ```\n\n\n.. column::\n\n If your event was defined with a dynamic path, you can use `*` to catch any action.\n\n.. column::\n\n ```python\n @app.signal(\"foo.bar.\")\n\n ...\n\n await app.event(\"foo.bar.*\")\n ```\n\n## Dispatching\n\n*In the future, Sanic will dispatch some events automatically to assist developers to hook into life cycle events.*\n\n.. column::\n\n Dispatching an event will do two things:\n\n 1. execute any signal handlers defined on the event, and\n 2. resolve anything that is \"waiting\" for the event to complete.\n\n.. column::\n\n ```python\n @app.signal(\"foo.bar.\")\n async def foo_bar(thing):\n print(f\"{thing=}\")\n\n await app.dispatch(\"foo.bar.baz\")\n ```\n ```\n thing=baz\n ```\n\n### Context\n\n.. column::\n\n Sometimes you may find the need to pass extra information into the signal handler. In our first example above, we wanted our email registration process to have the email address for the user.\n\n.. column::\n\n ```python\n @app.signal(\"user.registration.created\")\n async def send_registration_email(**context):\n print(context)\n\n await app.dispatch(\n \"user.registration.created\",\n context={\"hello\": \"world\"}\n )\n ```\n ```\n {'hello': 'world'}\n ```\n\n\n\n.. tip:: FYI\n\n Signals are dispatched in a background task.\n\n\n### Blueprints\n\nDispatching blueprint signals works similar in concept to [middleware](../basics/middleware.md). Anything that is done from the app level, will trickle down to the blueprints. However, dispatching on a blueprint, will only execute the signals that are defined on that blueprint.\n\n.. column::\n\n Perhaps an example is easier to explain:\n\n.. column::\n\n ```python\n bp = Blueprint(\"bp\")\n\n app_counter = 0\n bp_counter = 0\n\n @app.signal(\"foo.bar.baz\")\n def app_signal():\n nonlocal app_counter\n app_counter += 1\n\n @bp.signal(\"foo.bar.baz\")\n def bp_signal():\n nonlocal bp_counter\n bp_counter += 1\n ```\n\n\n.. column::\n\n Running `app.dispatch(\"foo.bar.baz\")` will execute both signals.\n\n.. column::\n\n ```python\n await app.dispatch(\"foo.bar.baz\")\n assert app_counter == 1\n assert bp_counter == 1\n ```\n\n\n.. column::\n\n Running `bp.dispatch(\"foo.bar.baz\")` will execute only the blueprint signal.\n\n.. column::\n\n ```python\n await bp.dispatch(\"foo.bar.baz\")\n assert app_counter == 1\n assert bp_counter == 2\n ```\n\n" }, { "path": "guide/content/en/guide/advanced/streaming.md", "content": "# Streaming\n\n## Request streaming\n\nSanic allows you to stream data sent by the client to begin processing data as the bytes arrive.\n\n.. column::\n\n When enabled on an endpoint, you can stream the request body using `await request.stream.read()`.\n\n That method will return `None` when the body is completed.\n\n.. column::\n\n ```python\n from sanic.views import stream\n\n class SimpleView(HTTPMethodView):\n @stream\n async def post(self, request):\n result = \"\"\n while True:\n body = await request.stream.read()\n if body is None:\n break\n result += body.decode(\"utf-8\")\n return text(result)\n ```\n\n\n.. column::\n\n It also can be enabled with a keyword argument in the decorator...\n\n.. column::\n\n ```python\n @app.post(\"/stream\", stream=True)\n async def handler(request):\n ...\n body = await request.stream.read()\n ...\n ```\n\n\n.. column::\n\n ... or the `add_route()` method.\n\n.. column::\n\n ```python\n bp.add_route(\n bp_handler,\n \"/bp_stream\",\n methods=[\"POST\"],\n stream=True,\n )\n ```\n\n\n\n.. tip:: FYI\n\n Only post, put and patch decorators have stream argument.\n\n\n## Response streaming\n\n.. column::\n\n Sanic allows you to stream content to the client.\n\n.. column::\n\n ```python\n @app.route(\"/\")\n async def test(request):\n response = await request.respond(content_type=\"text/csv\")\n await response.send(\"foo,\")\n await response.send(\"bar\")\n\n # Optionally, you can explicitly end the stream by calling:\n await response.eof()\n ```\n\nThis is useful in situations where you want to stream content to the client that originates in an external service, like a database. For example, you can stream database records to the client with the asynchronous cursor that `asyncpg` provides.\n\n```python\n@app.route(\"/\")\nasync def index(request):\n response = await request.respond()\n conn = await asyncpg.connect(database='test')\n async with conn.transaction():\n async for record in conn.cursor('SELECT generate_series(0, 10)'):\n await response.send(record[0])\n```\n\n\nYou can explicitly end a stream by calling `await response.eof()`. It a convenience method to replace `await response.send(\"\", True)`. It should be called **one time** *after* your handler has determined that it has nothing left to send back to the client. While it is *optional* to use with Sanic server, if you are running Sanic in ASGI mode, then you **must** explicitly terminate the stream.\n\n*Calling `eof` became optional in v21.6*\n\n## File streaming\n\n.. column::\n\n Sanic provides `sanic.response.file_stream` function that is useful when you want to send a large file. It returns a `StreamingHTTPResponse` object and will use chunked transfer encoding by default; for this reason Sanic doesn’t add `Content-Length` HTTP header in the response.\n\n A typical use case might be streaming an video file.\n\n.. column::\n\n ```python\n @app.route(\"/mp4\")\n async def handler_file_stream(request):\n return await response.file_stream(\n \"/path/to/sample.mp4\",\n chunk_size=1024,\n mime_type=\"application/metalink4+xml\",\n headers={\n \"Content-Disposition\": 'Attachment; filename=\"nicer_name.meta4\"',\n \"Content-Type\": \"application/metalink4+xml\",\n },\n )\n ```\n\n\n.. column::\n\n If you want to use the `Content-Length` header, you can disable chunked transfer encoding and add it manually simply by adding the `Content-Length` header.\n\n.. column::\n\n ```python\n from aiofiles import os as async_os\n from sanic.response import file_stream\n\n @app.route(\"/\")\n async def index(request):\n file_path = \"/srv/www/whatever.png\"\n\n file_stat = await async_os.stat(file_path)\n headers = {\"Content-Length\": str(file_stat.st_size)}\n\n return await file_stream(\n file_path,\n headers=headers,\n )\n ```\n\n" }, { "path": "guide/content/en/guide/advanced/versioning.md", "content": "# Versioning\n\nIt is standard practice in API building to add versions to your endpoints. This allows you to easily differentiate incompatible endpoints when you try and change your API down the road in a breaking manner.\n\nAdding a version will add a `/v{version}` url prefix to your endpoints.\n\nThe version can be a `int`, `float`, or `str`. Acceptable values:\n\n- `1`, `2`, `3`\n- `1.1`, `2.25`, `3.0`\n- `\"1\"`, `\"v1\"`, `\"v1.1\"`\n\n## Per route\n\n.. column::\n\n You can pass a version number to the routes directly.\n\n.. column::\n\n ```python\n # /v1/text\n @app.route(\"/text\", version=1)\n def handle_request(request):\n return response.text(\"Hello world! Version 1\")\n\n # /v2/text\n @app.route(\"/text\", version=2)\n def handle_request(request):\n return response.text(\"Hello world! Version 2\")\n ```\n\n## Per Blueprint\n\n.. column::\n\n You can also pass a version number to the blueprint, which will apply to all routes in that blueprint.\n\n.. column::\n\n ```python\n bp = Blueprint(\"test\", url_prefix=\"/foo\", version=1)\n\n # /v1/foo/html\n @bp.route(\"/html\")\n def handle_request(request):\n return response.html(\"

Hello world!

\")\n ```\n\n## Per Blueprint Group\n\n.. column::\n\n In order to simplify the management of the versioned blueprints, you can provide a version number in the blueprint\n group. The same will be inherited to all the blueprint grouped under it if the blueprints don't already override the\n same information with a value specified while creating a blueprint instance.\n\n When using blueprint groups for managing the versions, the following order is followed to apply the Version prefix to\n the routes being registered.\n\n 1. Route Level configuration\n 2. Blueprint level configuration\n 3. Blueprint Group level configuration\n\n If we find a more pointed versioning specification, we will pick that over the more generic versioning specification\n provided under the Blueprint or Blueprint Group\n\n.. column::\n\n ```python\n from sanic.blueprints import Blueprint\n from sanic.response import json\n\n bp1 = Blueprint(\n name=\"blueprint-1\",\n url_prefix=\"/bp1\",\n version=1.25,\n )\n bp2 = Blueprint(\n name=\"blueprint-2\",\n url_prefix=\"/bp2\",\n )\n\n group = Blueprint.group(\n [bp1, bp2],\n url_prefix=\"/bp-group\",\n version=\"v2\",\n )\n\n # GET /v1.25/bp-group/bp1/endpoint-1\n @bp1.get(\"/endpoint-1\")\n async def handle_endpoint_1_bp1(request):\n return json({\"Source\": \"blueprint-1/endpoint-1\"})\n\n # GET /v2/bp-group/bp2/endpoint-2\n @bp2.get(\"/endpoint-1\")\n async def handle_endpoint_1_bp2(request):\n return json({\"Source\": \"blueprint-2/endpoint-1\"})\n\n # GET /v1/bp-group/bp2/endpoint-2\n @bp2.get(\"/endpoint-2\", version=1)\n async def handle_endpoint_2_bp2(request):\n return json({\"Source\": \"blueprint-2/endpoint-2\"})\n ```\n\n## Version prefix\n\nAs seen above, the `version` that is applied to a route is **always** the first segment in the generated URI path. Therefore, to make it possible to add path segments before the version, every place that a `version` argument is passed, you can also pass `version_prefix`. \n\nThe `version_prefix` argument can be defined in:\n\n- `app.route` and `bp.route` decorators (and all the convenience decorators also)\n- `Blueprint` instantiation\n- `Blueprint.group` constructor\n- `BlueprintGroup` instantiation\n- `app.blueprint` registration\n\nIf there are definitions in multiple places, a more specific definition overrides a more general. This list provides that hierarchy.\n\nThe default value of `version_prefix` is `/v`.\n\n.. column::\n\n An often requested feature is to be able to mount versioned routes on `/api`. This can easily be accomplished with `version_prefix`.\n\n.. column::\n\n ```python\n # /v1/my/path\n app.route(\"/my/path\", version=1, version_prefix=\"/api/v\")\n ```\n\n\n.. column::\n\n Perhaps a more compelling usage is to load all `/api` routes into a single `BlueprintGroup`.\n\n.. column::\n\n ```python\n # /v1/my/path\n app = Sanic(__name__)\n v2ip = Blueprint(\"v2ip\", url_prefix=\"/ip\", version=2)\n api = Blueprint.group(v2ip, version_prefix=\"/api/version\")\n\n # /api/version2/ip\n @v2ip.get(\"/\")\n async def handler(request):\n return text(request.ip)\n\n app.blueprint(api)\n ```\n\nWe can therefore learn that a route's URI is:\n\n```\nversion_prefix + version + url_prefix + URI definition\n```\n\n\n.. tip:: \n \n Just like with `url_prefix`, it is possible to define path parameters inside a `version_prefix`. It is perfectly legitimate to do this. Just remember that every route will have that parameter injected into the handler.\n\n ```python\n version_prefix=\"//v\"\n ```\n\n\n*Added in v21.6*\n" }, { "path": "guide/content/en/guide/advanced/websockets.md", "content": "# Websockets\n\nSanic provides an easy to use abstraction on top of [websockets](https://websockets.readthedocs.io/en/stable/).\n\n## Routing\n\n.. column::\n\n Websocket handlers can be hooked up to the router similar to regular handlers.\n\n.. column::\n\n ```python\n from sanic import Request, Websocket\n\n async def feed(request: Request, ws: Websocket):\n pass\n\n app.add_websocket_route(feed, \"/feed\")\n ```\n ```python\n from sanic import Request, Websocket\n\n @app.websocket(\"/feed\")\n async def feed(request: Request, ws: Websocket):\n pass\n ```\n\n## Handler\n\n\n.. column::\n\n Typically, a websocket handler will want to hold open a loop.\n\n It can then use the `send()` and `recv()` methods on the second object injected into the handler.\n\n This example is a simple endpoint that echos back to the client messages that it receives.\n\n.. column::\n\n ```python\n from sanic import Request, Websocket\n\n @app.websocket(\"/feed\")\n async def feed(request: Request, ws: Websocket):\n while True:\n data = \"hello!\"\n print(\"Sending: \" + data)\n await ws.send(data)\n data = await ws.recv()\n print(\"Received: \" + data)\n ```\n\n\n.. column::\n\n You can simplify your loop by just iterating over the `Websocket` object in a for loop.\n\n *Added in v22.9*\n\n.. column::\n\n ```python\n from sanic import Request, Websocket\n\n @app.websocket(\"/feed\")\n async def feed(request: Request, ws: Websocket):\n async for msg in ws:\n await ws.send(msg)\n ```\n\n\n## Configuration\n\nSee [configuration section](../running/configuration.md) for more details, however the defaults are shown below.\n\n```python\napp.config.WEBSOCKET_MAX_SIZE = 2 ** 20\napp.config.WEBSOCKET_PING_INTERVAL = 20\napp.config.WEBSOCKET_PING_TIMEOUT = 20\n```\n" }, { "path": "guide/content/en/guide/basics/README.md", "content": "# Basics\n" }, { "path": "guide/content/en/guide/basics/app.md", "content": "---\ntitle: Sanic Application\n---\n\n# Sanic Application\n\nSee API docs: [sanic.app](/api/sanic.app)\n\n## Instance\n\n.. column::\n\n The most basic building block is the :class:`sanic.app.Sanic` instance. It is not required, but the custom is to instantiate this in a file called `server.py`.\n\n.. column::\n\n ```python\n # /path/to/server.py\n\n from sanic import Sanic\n\n app = Sanic(\"MyHelloWorldApp\")\n ```\n\n## Application context\n\nMost applications will have the need to share/reuse data or objects across different parts of the code base. Sanic helps be providing the `ctx` object on application instances. It is a free space for the developer to attach any objects or data that should existe throughout the lifetime of the application.\n\n\n.. column::\n\n The most common pattern is to attach a database instance to the application.\n\n.. column::\n\n ```python\n app = Sanic(\"MyApp\")\n app.ctx.db = Database()\n ```\n\n\n.. column::\n\n While the previous example will work and is illustrative, it is typically considered best practice to attach objects in one of the two application startup [listeners](./listeners).\n\n.. column::\n\n ```python\n app = Sanic(\"MyApp\")\n\n @app.before_server_start\n async def attach_db(app, loop):\n app.ctx.db = Database()\n ```\n\n\n## App Registry\n\n.. column::\n\n When you instantiate a Sanic instance, that can be retrieved at a later time from the Sanic app registry. This can be useful, for example, if you need to access your Sanic instance from a location where it is not otherwise accessible.\n\n.. column::\n\n ```python\n # ./path/to/server.py\n from sanic import Sanic\n\n app = Sanic(\"my_awesome_server\")\n\n # ./path/to/somewhere_else.py\n from sanic import Sanic\n\n app = Sanic.get_app(\"my_awesome_server\")\n ```\n\n\n.. column::\n\n If you call `Sanic.get_app(\"non-existing\")` on an app that does not exist, it will raise :class:`sanic.exceptions.SanicException` by default. You can, instead, force the method to return a new instance of Sanic with that name.\n\n.. column::\n\n ```python\n app = Sanic.get_app(\n \"non-existing\",\n force_create=True,\n )\n ```\n\n\n.. column::\n\n If there is **only one** Sanic instance registered, then calling `Sanic.get_app()` with no arguments will return that instance\n\n.. column::\n\n ```python\n Sanic(\"My only app\")\n\n app = Sanic.get_app()\n ```\n\n## Configuration\n\n.. column::\n\n Sanic holds the configuration in the `config` attribute of the `Sanic` instance. Configuration can be modified **either** using dot-notation **OR** like a dictionary.\n\n.. column::\n\n ```python\n app = Sanic('myapp')\n\n app.config.DB_NAME = 'appdb'\n app.config['DB_USER'] = 'appuser'\n\n db_settings = {\n 'DB_HOST': 'localhost',\n 'DB_NAME': 'appdb',\n 'DB_USER': 'appuser'\n }\n app.config.update(db_settings)\n ```\n\n\n\n.. note:: Heads up\n\n Config keys _should_ be uppercase. But, this is mainly by convention, and lowercase will work most of the time.\n ```python\n app.config.GOOD = \"yay!\"\n app.config.bad = \"boo\"\n ```\n\n\nThere is much [more detail about configuration](../running/configuration.md) later on.\n\n## Factory pattern\n\nMany of the examples in these docs will show the instantiation of the :class:`sanic.app.Sanic` instance in a file called `server.py` in the \"global scope\" (i.e. not inside a function). This is a common pattern for very simple \"hello world\" style applications, but it is often beneficial to use a factory pattern instead.\n\nA \"factory\" is just a function that returns an instance of the object you want to use. This allows you to abstract the instantiation of the object, but also may make it easier to isolate the application instance.\n\n.. column::\n\n A super simple factory pattern could look like this:\n \n.. column::\n\n ```python\n # ./path/to/server.py\n from sanic import Sanic\n from .path.to.config import MyConfig\n from .path.to.some.blueprint import bp\n \n \n def create_app(config=MyConfig) -> Sanic:\n app = Sanic(\"MyApp\", config=config)\n app.blueprint(bp)\n return app\n ```\n\n.. column::\n\n When we get to running Sanic later, you will learn that the Sanic CLI can detect this pattern and use it to run your application.\n \n.. column::\n\n ```sh\n sanic path.to.server:create_app\n ```\n\n## Customization\n\nThe Sanic application instance can be customized for your application needs in a variety of ways at instantiation.\n\nFor complete details, see the [API docs](/api/sanic.app).\n\n### Custom configuration\n\n.. column::\n\n This simplest form of custom configuration would be to pass your own object directly into that Sanic application instance\n\n If you create a custom configuration object, it is *highly* recommended that you subclass the :class:`sanic.config.Config` option to inherit its behavior. You could use this option for adding properties, or your own set of custom logic.\n\n *Added in v21.6*\n\n.. column::\n\n ```python\n from sanic.config import Config\n\n class MyConfig(Config):\n FOO = \"bar\"\n\n app = Sanic(..., config=MyConfig())\n ```\n\n\n.. column::\n\n A useful example of this feature would be if you wanted to use a config file in a form that differs from what is [supported](../running/configuration.md#using-sanicupdateconfig).\n\n.. column::\n\n ```python\n from sanic import Sanic, text\n from sanic.config import Config\n\n class TomlConfig(Config):\n def __init__(self, *args, path: str, **kwargs):\n super().__init__(*args, **kwargs)\n\n with open(path, \"r\") as f:\n self.apply(toml.load(f))\n\n def apply(self, config):\n self.update(self._to_uppercase(config))\n\n def _to_uppercase(self, obj: Dict[str, Any]) -> Dict[str, Any]:\n retval: Dict[str, Any] = {}\n for key, value in obj.items():\n upper_key = key.upper()\n if isinstance(value, list):\n retval[upper_key] = [\n self._to_uppercase(item) for item in value\n ]\n elif isinstance(value, dict):\n retval[upper_key] = self._to_uppercase(value)\n else:\n retval[upper_key] = value\n return retval\n\n toml_config = TomlConfig(path=\"/path/to/config.toml\")\n app = Sanic(toml_config.APP_NAME, config=toml_config)\n ```\n\n### Custom context\n\n.. column::\n\n By default, the application context is a [`SimpleNamespace()`](https://docs.python.org/3/library/types.html#types.SimpleNamespace) that allows you to set any properties you want on it. However, you also have the option of passing any object whatsoever instead.\n\n *Added in v21.6*\n\n.. column::\n\n ```python\n app = Sanic(..., ctx=1)\n ```\n\n ```python\n app = Sanic(..., ctx={})\n ```\n\n ```python\n class MyContext:\n ...\n\n app = Sanic(..., ctx=MyContext())\n ```\n\n### Custom requests\n\n.. column::\n\n It is sometimes helpful to have your own `Request` class, and tell Sanic to use that instead of the default. One example is if you wanted to modify the default `request.id` generator.\n\n \n\n .. note:: Important\n\n It is important to remember that you are passing the *class* not an instance of the class.\n\n\n.. column::\n\n ```python\n import time\n\n from sanic import Request, Sanic, text\n\n class NanoSecondRequest(Request):\n @classmethod\n def generate_id(*_):\n return time.time_ns()\n\n app = Sanic(..., request_class=NanoSecondRequest)\n\n @app.get(\"/\")\n async def handler(request):\n return text(str(request.id))\n ```\n\n### Custom error handler\n\n.. column::\n\n See [exception handling](../best-practices/exceptions.md#custom-error-handling) for more\n\n.. column::\n\n ```python\n from sanic.handlers import ErrorHandler\n\n class CustomErrorHandler(ErrorHandler):\n def default(self, request, exception):\n ''' handles errors that have no error handlers assigned '''\n # You custom error handling logic...\n return super().default(request, exception)\n\n app = Sanic(..., error_handler=CustomErrorHandler())\n ```\n\n### Custom dumps function\n\n.. column::\n\n It may sometimes be necessary or desirable to provide a custom function that serializes an object to JSON data.\n\n.. column::\n\n ```python\n import ujson\n\n dumps = partial(ujson.dumps, escape_forward_slashes=False)\n app = Sanic(__name__, dumps=dumps)\n ```\n\n\n.. column::\n\n Or, perhaps use another library or create your own.\n\n.. column::\n\n ```python\n from orjson import dumps\n\n app = Sanic(\"MyApp\", dumps=dumps)\n ```\n\n### Custom loads function\n\n.. column::\n\n Similar to `dumps`, you can also provide a custom function for deserializing data.\n\n *Added in v22.9*\n\n.. column::\n\n ```python\n from orjson import loads\n\n app = Sanic(\"MyApp\", loads=loads)\n ```\n\n\n\n### Custom typed application\n\nBeginning in v23.6, the correct type annotation of a default Sanic application instance is:\n\n```python\nsanic.app.Sanic[sanic.config.Config, types.SimpleNamespace]\n```\n\nIt refers to two generic types:\n\n1. The first is the type of the configuration object. It defaults to :class:`sanic.config.Config`, but can be any subclass of that.\n2. The second is the type of the application context. It defaults to [`SimpleNamespace()`](https://docs.python.org/3/library/types.html#types.SimpleNamespace), but can be **any object** as show above.\n\nLet's look at some examples of how the type will change.\n\n.. column::\n\n Consider this example where we pass a custom subclass of :class:`sanic.config.Config` and a custom context object.\n\n.. column::\n\n ```python\n from sanic import Sanic\n from sanic.config import Config\n\n class CustomConfig(Config):\n pass\n\n app = Sanic(\"test\", config=CustomConfig())\n reveal_type(app) # N: Revealed type is \"sanic.app.Sanic[main.CustomConfig, types.SimpleNamespace]\"\n ```\n ```\n sanic.app.Sanic[main.CustomConfig, types.SimpleNamespace]\n ```\n\n\n.. column::\n\n Similarly, when passing a custom context object, the type will change to reflect that.\n\n.. column::\n\n ```python\n from sanic import Sanic\n\n class Foo:\n pass\n\n app = Sanic(\"test\", ctx=Foo())\n reveal_type(app) # N: Revealed type is \"sanic.app.Sanic[sanic.config.Config, main.Foo]\"\n ```\n ```\n sanic.app.Sanic[sanic.config.Config, main.Foo]\n ```\n\n\n.. column::\n\n Of course, you can set both the config and context to custom types.\n\n.. column::\n\n ```python\n from sanic import Sanic\n from sanic.config import Config\n\n class CustomConfig(Config):\n pass\n\n class Foo:\n pass\n\n app = Sanic(\"test\", config=CustomConfig(), ctx=Foo())\n reveal_type(app) # N: Revealed type is \"sanic.app.Sanic[main.CustomConfig, main.Foo]\"\n ```\n ```\n sanic.app.Sanic[main.CustomConfig, main.Foo]\n ```\n\nThis pattern is particularly useful if you create a custom type alias for your application instance so that you can use it to annotate listeners and handlers.\n\n```python\n# ./path/to/types.py\nfrom sanic.app import Sanic\nfrom sanic.config import Config\nfrom myapp.context import MyContext\nfrom typing import TypeAlias\n\nMyApp = TypeAlias(\"MyApp\", Sanic[Config, MyContext])\n```\n\n```python\n# ./path/to/listeners.py\nfrom myapp.types import MyApp\n\ndef add_listeners(app: MyApp):\n @app.before_server_start\n async def before_server_start(app: MyApp):\n # do something with your fully typed app instance\n await app.ctx.db.connect()\n```\n\n```python\n# ./path/to/server.py\nfrom myapp.types import MyApp\nfrom myapp.context import MyContext\nfrom myapp.config import MyConfig\nfrom myapp.listeners import add_listeners\n\napp = Sanic(\"myapp\", config=MyConfig(), ctx=MyContext())\nadd_listeners(app)\n```\n\n*Added in v23.6*\n\n### Custom typed request\n\nSanic also allows you to customize the type of the request object. This is useful if you want to add custom properties to the request object, or be able to access your custom properties of a typed application instance.\n\nThe correct, default type of a Sanic request instance is:\n\n```python\nsanic.request.Request[\n sanic.app.Sanic[sanic.config.Config, types.SimpleNamespace],\n types.SimpleNamespace\n]\n```\n\nIt refers to two generic types:\n\n1. The first is the type of the application instance. It defaults to `sanic.app.Sanic[sanic.config.Config, types.SimpleNamespace]`, but can be any subclass of that.\n2. The second is the type of the request context. It defaults to `types.SimpleNamespace`, but can be **any object** as show above in [custom requests](#custom-requests).\n\nLet's look at some examples of how the type will change.\n\n.. column::\n\n Expanding upon the full example above where there is a type alias for a customized application instance, we can also create a custom request type so that we can access those same type annotations.\n\n Of course, you do not need type aliases for this to work. We are only showing them here to cut down on the amount of code shown.\n\n.. column::\n\n ```python\n from sanic import Request\n from myapp.types import MyApp\n from types import SimpleNamespace\n\n def add_routes(app: MyApp):\n @app.get(\"/\")\n async def handler(request: Request[MyApp, SimpleNamespace]):\n # do something with your fully typed app instance\n results = await request.app.ctx.db.query(\"SELECT * FROM foo\")\n ```\n\n\n.. column::\n\n Perhaps you have a custom request object that generates a custom context object. You can type annotate it to properly access those properties with your IDE as shown here.\n\n.. column::\n\n ```python\n from sanic import Request, Sanic\n from sanic.config import Config\n\n class CustomConfig(Config):\n pass\n\n class Foo:\n pass\n\n class RequestContext:\n foo: Foo\n\n class CustomRequest(Request[Sanic[CustomConfig, Foo], RequestContext]):\n @staticmethod\n def make_context() -> RequestContext:\n ctx = RequestContext()\n ctx.foo = Foo()\n return ctx\n\n app = Sanic(\n \"test\", config=CustomConfig(), ctx=Foo(), request_class=CustomRequest\n )\n\n @app.get(\"/\")\n async def handler(request: CustomRequest):\n # Full access to typed:\n # - custom application configuration object\n # - custom application context object\n # - custom request context object\n pass\n ```\n\nSee more information in the [custom request context](./request.md#custom-request-context) section.\n\n*Added in v23.6*\n\n" }, { "path": "guide/content/en/guide/basics/cookies.md", "content": "# Cookies\n\n## Reading\n\n.. column::\n\n Cookies can be accessed via the `Request` object’s `cookies` dictionary.\n\n.. column::\n\n ```python\n @app.route(\"/cookie\")\n async def test(request):\n test_cookie = request.cookies.get(\"test\")\n return text(f\"Test cookie: {test_cookie}\")\n ```\n\n\n\n.. tip:: FYI\n\n 💡 The `request.cookies` object is one of a few types that is a dictionary with each value being a `list`. This is because HTTP allows a single key to be reused to send multiple values.\n\n Most of the time you will want to use the `.get()` method to access the first element and not a `list`. If you do want a `list` of all items, you can use `.getlist()`.\n\n *Added in v23.3*\n\n\n\n## Writing\n\n.. column::\n\n When returning a response, cookies can be set on the `Response` object: `response.cookies`. This object is an instance of `CookieJar` which is a special sort of dictionary that automatically will write the response headers for you.\n\n.. column::\n\n ```python\n @app.route(\"/cookie\")\n async def test(request):\n response = text(\"There's a cookie up in this response\")\n response.add_cookie(\n \"test\",\n \"It worked!\",\n domain=\".yummy-yummy-cookie.com\",\n httponly=True\n )\n return response\n ```\n\nResponse cookies can be set like dictionary values and have the following parameters available:\n\n- `path: str` - The subset of URLs to which this cookie applies. Defaults to `/`.\n- `domain: str` - Specifies the domain for which the cookie is valid. An explicitly specified domain must always start with a dot.\n- `max_age: int` - Number of seconds the cookie should live for.\n- `expires: datetime` - The time for the cookie to expire on the client’s browser. Usually it is better to use max-age instead.\n- `secure: bool` - Specifies whether the cookie will only be sent via HTTPS. Defaults to `True`.\n- `httponly: bool` - Specifies whether the cookie cannot be read by JavaScript.\n- `samesite: str` - Available values: Lax, Strict, and None. Defaults to `Lax`.\n- `comment: str` - A comment (metadata).\n- `host_prefix: bool` - Whether to add the `__Host-` prefix to the cookie.\n- `secure_prefix: bool` - Whether to add the `__Secure-` prefix to the cookie.\n- `partitioned: bool` - Whether to mark the cookie as partitioned.\n\nTo better understand the implications and usage of these values, it might be helpful to read the [MDN documentation](https://developer.mozilla.org/en-US/docs/Web/HTTP/Cookies) on [setting cookies](https://developer.mozilla.org/en-US/docs/Web/HTTP/Headers/Set-Cookie).\n\n\n.. tip:: FYI\n\n By default, Sanic will set the `secure` flag to `True` to ensure that cookies are only sent over HTTPS as a sensible default. This should not be impactful for local development since secure cookies over HTTP should still be sent to `localhost`. For more information, you should read the [MDN documentation](https://developer.mozilla.org/en-US/docs/Web/HTTP/Cookies#restrict_access_to_cookies) on [secure cookies](https://developer.mozilla.org/en-US/docs/Web/HTTP/Headers/Set-Cookie#Secure).\n\n\n## Deleting\n\n.. column::\n\n Cookies can be removed semantically or explicitly.\n\n.. column::\n\n ```python\n @app.route(\"/cookie\")\n async def test(request):\n response = text(\"Time to eat some cookies muahaha\")\n\n # This cookie will be set to expire in 0 seconds\n response.delete_cookie(\"eat_me\")\n\n # This cookie will self destruct in 5 seconds\n response.add_cookie(\"fast_bake\", \"Be quick!\", max_age=5)\n\n return response\n ```\n\n *Don't forget to add `path` or `domain` if needed!*\n\n## Eating\n\n.. column::\n\n Sanic likes cookies\n \n.. column::\n\n .. attrs::\n :class: is-size-1 has-text-centered\n \n 🍪\n" }, { "path": "guide/content/en/guide/basics/handlers.md", "content": "# Handlers\n\nThe next important building block are your _handlers_. These are also sometimes called \"views\".\n\nIn Sanic, a handler is any callable that takes at least a :class:`sanic.request.Request` instance as an argument, and returns either an :class:`sanic.response.HTTPResponse` instance, or a coroutine that does the same.\n\n.. column::\n\n Huh? 😕\n\n It is a **function**; either synchronous or asynchronous.\n\n The job of the handler is to respond to an endpoint and do something. This is where the majority of your business logic will go.\n\n.. column::\n\n ```python\n def i_am_a_handler(request):\n return HTTPResponse()\n\n async def i_am_ALSO_a_handler(request):\n return HTTPResponse()\n ```\n\nTwo more important items to note:\n\n1. You almost *never* will want to use :class:`sanic.response.HTTPresponse` directly. It is much simpler to use one of the [convenience methods](./response.md#methods).\n\n - `from sanic import json`\n - `from sanic import html`\n - `from sanic import redirect`\n - *etc*\n \n1. As we will see in [the streaming section](../advanced/streaming.md#response-streaming), you do not always need to return an object. If you use this lower-level API, you can control the flow of the response from within the handler, and a return object is not used.\n\n.. tip:: Heads up\n\n If you want to learn more about encapsulating your logic, checkout [class based views](../advanced/class-based-views.md). For now, we will continue forward with just function-based views.\n\n\n### A simple function-based handler\n\nThe most common way to create a route handler is to decorate the function. It creates a visually simple identification of a route definition. We'll learn more about [routing soon](./routing.md).\n\n.. column::\n\n Let's look at a practical example.\n\n - We use a convenience decorator on our app instance: `@app.get()`\n - And a handy convenience method for generating out response object: `text()`\n\n Mission accomplished 💪\n\n.. column::\n\n ```python\n from sanic import text\n\n @app.get(\"/foo\")\n async def foo_handler(request):\n return text(\"I said foo!\")\n ```\n\n---\n\n## A word about _async_...\n\n.. column::\n\n It is entirely possible to write handlers that are synchronous.\n\n In this example, we are using the _blocking_ `time.sleep()` to simulate 100ms of processing time. Perhaps this represents fetching data from a DB, or a 3rd-party website.\n\n Using four (4) worker processes and a common benchmarking tool:\n\n - **956** requests in 30.10s\n - Or, about **31.76** requests/second\n\n.. column::\n\n ```python\n @app.get(\"/sync\")\n def sync_handler(request):\n time.sleep(0.1)\n return text(\"Done.\")\n ```\n\n\n.. column::\n\n Just by changing to the asynchronous alternative `asyncio.sleep()`, we see an incredible change in performance. 🚀\n\n Using the same four (4) worker processes:\n\n - **115,590** requests in 30.08s\n - Or, about **3,843.17** requests/second\n\n .. attrs::\n :class: is-size-2\n \n 🤯\n\n.. column::\n\n ```python\n @app.get(\"/async\")\n async def async_handler(request):\n await asyncio.sleep(0.1)\n return text(\"Done.\")\n ```\n\n\nOkay... this is a ridiculously overdramatic result. And any benchmark you see is inherently very biased. This example is meant to over-the-top show the benefit of `async/await` in the web world. Results will certainly vary. Tools like Sanic and other async Python libraries are not magic bullets that make things faster. They make them _more efficient_.\n\nIn our example, the asynchronous version is so much better because while one request is sleeping, it is able to start another one, and another one, and another one, and another one...\n\nBut, this is the point! Sanic is fast because it takes the available resources and squeezes performance out of them. It can handle many requests concurrently, which means more requests per second.\n\n\n.. tip:: A common mistake!\n\n Don't do this! You need to ping a website. What do you use? `pip install your-fav-request-library` 🙈\n\n Instead, try using a client that is `async/await` capable. Your server will thank you. Avoid using blocking tools, and favor those that play well in the asynchronous ecosystem. If you need recommendations, check out [Awesome Sanic](https://github.com/mekicha/awesome-sanic).\n\n Sanic uses [httpx](https://www.python-httpx.org/) inside of its testing package (sanic-testing) 😉.\n\n\n---\n\n## A fully annotated handler\n\nFor those that are using type annotations...\n\n```python\nfrom sanic.response import HTTPResponse, text\nfrom sanic.request import Request\n\n@app.get(\"/typed\")\nasync def typed_handler(request: Request) -> HTTPResponse:\n return text(\"Done.\")\n```\n\n## Naming your handlers\n\nAll handlers are named automatically. This is useful for debugging, and for generating URLs in templates. When not specified, the name that will be used is the name of the function.\n\n.. column::\n\n For example, this handler will be named `foo_handler`.\n\n.. column::\n\n ```python\n # Handler name will be \"foo_handler\"\n @app.get(\"/foo\")\n async def foo_handler(request):\n return text(\"I said foo!\")\n ```\n\n.. column::\n\n However, you can override this by passing the `name` argument to the decorator.\n\n.. column::\n\n ```python\n # Handler name will be \"foo\"\n @app.get(\"/foo\", name=\"foo\")\n async def foo_handler(request):\n return text(\"I said foo!\")\n ```\n\n.. column::\n\n In fact, as you will, there may be times when you **MUST** supply a name. For example, if you use two decorators on the same function, you will need to supply a name for at least one of them.\n \n If you do not, you will get an error and your app will not start. Names **must** be unique within your app.\n\n.. column::\n\n ```python\n # Two handlers, same function,\n # different names:\n # - \"foo_arg\"\n # - \"foo\"\n @app.get(\"/foo/\", name=\"foo_arg\")\n @app.get(\"/foo\")\n async def foo(request, arg=None):\n return text(\"I said foo!\")\n ```\n" }, { "path": "guide/content/en/guide/basics/headers.md", "content": "# Headers\n\nRequest and response headers are available in the `Request` and `HTTPResponse` objects, respectively. They make use of the [`multidict` package](https://multidict.readthedocs.io/en/stable/multidict.html#cimultidict) that allows a single key to have multiple values.\n\n\n.. tip:: FYI\n\n Header keys are converted to *lowercase* when parsed. Capitalization is not considered for headers.\n\n\n## Request\n\nSanic does attempt to do some normalization on request headers before presenting them to the developer, and also make some potentially meaningful extractions for common use cases.\n\n.. column::\n\n #### Tokens\n\n Authorization tokens in the form `Token ` or `Bearer ` are extracted to the request object: `request.token`.\n\n.. column::\n\n ```python\n @app.route(\"/\")\n async def handler(request):\n return text(request.token)\n ```\n\n ```sh\n curl localhost:8000 \\\n -H \"Authorization: Token ABCDEF12345679\"\n ABCDEF12345679\n ```\n\n ```sh\n curl localhost:8000 \\\n -H \"Authorization: Bearer eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9.eyJzdWIiOiIxMjM0NTY3ODkwIiwibmFtZSI6IkpvaG4gRG9lIiwiaWF0IjoxNTE2MjM5MDIyfQ.SflKxwRJSMeKKF2QT4fwpMeJf36POk6yJV_adQssw5c\"\n eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9.eyJzdWIiOiIxMjM0NTY3ODkwIiwibmFtZSI6IkpvaG4gRG9lIiwiaWF0IjoxNTE2MjM5MDIyfQ.SflKxwRJSMeKKF2QT4fwpMeJf36POk6yJV_adQssw5c\n ```\n\n### Proxy headers\n\nSanic has special handling for proxy headers. See the [proxy headers](../advanced/proxy-headers.md) section for more details.\n\n### Host header and dynamic URL construction\n\n.. column::\n\n The *effective host* is available via `request.host`. This is not necessarily the same as the host header, as it prefers proxy-forwarded host and can be forced by the server name setting.\n\n Webapps should generally use this accessor so that they can function the same no matter how they are deployed. The actual host header, if needed, can be found via `request.headers`\n\n The effective host is also used in dynamic URL construction via `request.url_for`, which uses the request to determine the external address of a handler.\n\n .. tip:: Be wary of malicious clients\n\n These URLs can be manipulated by sending misleading host headers. `app.url_for` should be used instead if this is a concern.\n\n.. column::\n\n ```python\n app.config.SERVER_NAME = \"https://example.com\"\n\n @app.route(\"/hosts\", name=\"foo\")\n async def handler(request):\n return json(\n {\n \"effective host\": request.host,\n \"host header\": request.headers.get(\"host\"),\n \"forwarded host\": request.forwarded.get(\"host\"),\n \"you are here\": request.url_for(\"foo\"),\n }\n )\n ```\n\n ```sh\n curl localhost:8000/hosts\n {\n \"effective host\": \"example.com\",\n \"host header\": \"localhost:8000\",\n \"forwarded host\": null,\n \"you are here\": \"https://example.com/hosts\"\n }\n ```\n\n### Other headers\n\n.. column::\n\n\n All request headers are available on `request.headers`, and can be accessed in dictionary form. Capitalization is not considered for headers, and can be accessed using either uppercase or lowercase keys.\n\n.. column::\n\n ```python\n @app.route(\"/\")\n async def handler(request):\n return json(\n {\n \"foo_weakref\": request.headers[\"foo\"],\n \"foo_get\": request.headers.get(\"Foo\"),\n \"foo_getone\": request.headers.getone(\"FOO\"),\n \"foo_getall\": request.headers.getall(\"fOo\"),\n \"all\": list(request.headers.items()),\n }\n )\n ```\n\n ```sh\n curl localhost:9999/headers -H \"Foo: one\" -H \"FOO: two\"|jq\n {\n \"foo_weakref\": \"one\",\n \"foo_get\": \"one\",\n \"foo_getone\": \"one\",\n \"foo_getall\": [\n \"one\",\n \"two\"\n ],\n \"all\": [\n [\n \"host\",\n \"localhost:9999\"\n ],\n [\n \"user-agent\",\n \"curl/7.76.1\"\n ],\n [\n \"accept\",\n \"*/*\"\n ],\n [\n \"foo\",\n \"one\"\n ],\n [\n \"foo\",\n \"two\"\n ]\n ]\n }\n ```\n\n\n\n.. tip:: FYI\n\n 💡 The request.headers object is one of a few types that is a dictionary with each value being a list. This is because HTTP allows a single key to be reused to send multiple values.\n\n Most of the time you will want to use the .get() or .getone() methods to access the first element and not a list. If you do want a list of all items, you can use .getall().\n\n\n### Request ID\n\n.. column::\n\n Often it is convenient or necessary to track a request by its `X-Request-ID` header. You can easily access that as: `request.id`.\n\n.. column::\n\n ```python\n @app.route(\"/\")\n async def handler(request):\n return text(request.id)\n ```\n\n ```sh\n curl localhost:8000 \\\n -H \"X-Request-ID: ABCDEF12345679\"\n ABCDEF12345679\n ```\n\n## Response\n\nSanic will automatically set the following response headers (when appropriate) for you:\n\n- `content-length`\n- `content-type`\n- `connection`\n- `transfer-encoding`\n\nIn most circumstances, you should never need to worry about setting these headers.\n\n.. column::\n\n Any other header that you would like to set can be done either in the route handler, or a response middleware.\n\n.. column::\n\n ```python\n @app.route(\"/\")\n async def handler(request):\n return text(\"Done.\", headers={\"content-language\": \"en-US\"})\n\n @app.middleware(\"response\")\n async def add_csp(request, response):\n response.headers[\"content-security-policy\"] = \"default-src 'none'; script-src 'self'; connect-src 'self'; img-src 'self'; style-src 'self';base-uri 'self';form-action 'self'\"\n ```\n\n\n.. column::\n\n A common [middleware](middleware.md) you might want is to add a `X-Request-ID` header to every response. As stated above: `request.id` will provide the ID from the incoming request. But, even if no ID was supplied in the request headers, one will be automatically supplied for you.\n\n [See API docs for more details](https://sanic.readthedocs.io/en/latest/sanic/api_reference.html#sanic.request.Request.id)\n\n.. column::\n\n ```python\n @app.route(\"/\")\n async def handler(request):\n return text(str(request.id))\n\n @app.on_response\n async def add_request_id_header(request, response):\n response.headers[\"X-Request-ID\"] = request.id\n ```\n\n ```sh\n curl localhost:8000 -i\n HTTP/1.1 200 OK\n X-Request-ID: 805a958e-9906-4e7a-8fe0-cbe83590431b\n content-length: 36\n connection: keep-alive\n content-type: text/plain; charset=utf-8\n\n 805a958e-9906-4e7a-8fe0-cbe83590431b\n ```\n\n" }, { "path": "guide/content/en/guide/basics/listeners.md", "content": "# Listeners\n\nSanic provides you with eight (8) opportunities to inject an operation into the life cycle of your application server. This does not include the [signals](../advanced/signals.md), which allow further injection customization.\n\nThere are two (2) that run **only** on your main Sanic process (ie, once per call to `sanic server.app`.)\n\n- `main_process_start`\n- `main_process_stop`\n\nThere are also two (2) that run **only** in a reloader process if auto-reload has been turned on.\n\n- `reload_process_start`\n- `reload_process_stop`\n\n*Added `reload_process_start` and `reload_process_stop` in v22.3*\n\nThere are four (4) that enable you to execute startup/teardown code as your server starts or closes.\n\n- `before_server_start`\n- `after_server_start`\n- `before_server_stop`\n- `after_server_stop`\n\nThe life cycle of a worker process looks like this:\n\n.. mermaid::\n\n sequenceDiagram\n autonumber\n participant Process\n participant Worker\n participant Listener\n participant Handler\n Note over Process: sanic server.app\n loop\n Process->>Listener: @app.main_process_start\n Listener->>Handler: Invoke event handler\n end\n Process->>Worker: Run workers\n loop Start each worker\n loop\n Worker->>Listener: @app.before_server_start\n Listener->>Handler: Invoke event handler\n end\n Note over Worker: Server status: started\n loop\n Worker->>Listener: @app.after_server_start\n Listener->>Handler: Invoke event handler\n end\n Note over Worker: Server status: ready\n end\n Process->>Worker: Graceful shutdown\n loop Stop each worker\n loop\n Worker->>Listener: @app.before_server_stop\n Listener->>Handler: Invoke event handler\n end\n Note over Worker: Server status: stopped\n loop\n Worker->>Listener: @app.after_server_stop\n Listener->>Handler: Invoke event handler\n end\n Note over Worker: Server status: closed\n end\n loop\n Process->>Listener: @app.main_process_stop\n Listener->>Handler: Invoke event handler\n end\n Note over Process: exit\n\n\nThe reloader process live outside of this worker process inside of a process that is responsible for starting and stopping the Sanic processes. Consider the following example:\n\n```python\n@app.reload_process_start\nasync def reload_start(*_):\n print(\">>>>>> reload_start <<<<<<\")\n\n@app.main_process_start\nasync def main_start(*_):\n print(\">>>>>> main_start <<<<<<\")\n\t\n@app.before_server_start\nasync def before_start(*_):\n\tprint(\">>>>>> before_start <<<<<<\")\n```\n\nIf this application were run with auto-reload turned on, the `reload_start` function would be called once when the reloader process starts. The `main_start` function would also be called once when the main process starts. **HOWEVER**, the `before_start` function would be called once for each worker process that is started, and subsequently every time that a file is saved and the worker is restarted.\n\n## Attaching a listener\n\n.. column::\n\n The process to setup a function as a listener is similar to declaring a route.\n\n The currently running `Sanic()` instance is injected into the listener.\n\n.. column::\n\n ```python\n async def setup_db(app):\n app.ctx.db = await db_setup()\n\n app.register_listener(setup_db, \"before_server_start\")\n ```\n\n\n.. column::\n\n The `Sanic` app instance also has a convenience decorator.\n\n.. column::\n\n ```python\n @app.listener(\"before_server_start\")\n async def setup_db(app):\n app.ctx.db = await db_setup()\n ```\n\n\n.. column::\n\n Prior to v22.3, both the application instance and the current event loop were injected into the function. However, only the application instance is injected by default. If your function signature will accept both, then both the application and the loop will be injected as shown here.\n\n.. column::\n\n ```python\n @app.listener(\"before_server_start\")\n async def setup_db(app, loop):\n app.ctx.db = await db_setup()\n ```\n\n\n.. column::\n\n You can shorten the decorator even further. This is helpful if you have an IDE with autocomplete.\n\n.. column::\n\n ```python\n @app.before_server_start\n async def setup_db(app):\n app.ctx.db = await db_setup()\n ```\n\n## Order of execution\n\nListeners are executed in the order they are declared during startup, and reverse order of declaration during teardown\n\n| | Phase | Order |\n|-----------------------|-----------------|---------|\n| `main_process_start` | main startup | regular 🙂 ⬇️ |\n| `before_server_start` | worker startup | regular 🙂 ⬇️ |\n| `after_server_start` | worker startup | regular 🙂 ⬇️ |\n| `before_server_stop` | worker shutdown | 🙃 ⬆️ reverse |\n| `after_server_stop` | worker shutdown | 🙃 ⬆️ reverse |\n| `main_process_stop` | main shutdown | 🙃 ⬆️ reverse |\n\nGiven the following setup, we should expect to see this in the console if we run two workers.\n\n.. column::\n\n ```python\n @app.listener(\"before_server_start\")\n async def listener_1(app, loop):\n print(\"listener_1\")\n\n @app.before_server_start\n async def listener_2(app, loop):\n print(\"listener_2\")\n\n @app.listener(\"after_server_start\")\n async def listener_3(app, loop):\n print(\"listener_3\")\n\n @app.after_server_start\n async def listener_4(app, loop):\n print(\"listener_4\")\n\n @app.listener(\"before_server_stop\")\n async def listener_5(app, loop):\n print(\"listener_5\")\n\n @app.before_server_stop\n async def listener_6(app, loop):\n print(\"listener_6\")\n\n @app.listener(\"after_server_stop\")\n async def listener_7(app, loop):\n print(\"listener_7\")\n\n @app.after_server_stop\n async def listener_8(app, loop):\n print(\"listener_8\")\n ```\n\n.. column::\n\n ```bash\n [pid: 1000000] [INFO] Goin' Fast @ http://127.0.0.1:9999\n [pid: 1000000] [INFO] listener_0\n [pid: 1111111] [INFO] listener_1\n [pid: 1111111] [INFO] listener_2\n [pid: 1111111] [INFO] listener_3\n [pid: 1111111] [INFO] listener_4\n [pid: 1111111] [INFO] Starting worker [1111111]\n [pid: 1222222] [INFO] listener_1\n [pid: 1222222] [INFO] listener_2\n [pid: 1222222] [INFO] listener_3\n [pid: 1222222] [INFO] listener_4\n [pid: 1222222] [INFO] Starting worker [1222222]\n [pid: 1111111] [INFO] Stopping worker [1111111]\n [pid: 1222222] [INFO] Stopping worker [1222222]\n [pid: 1222222] [INFO] listener_6\n [pid: 1222222] [INFO] listener_5\n [pid: 1222222] [INFO] listener_8\n [pid: 1222222] [INFO] listener_7\n [pid: 1111111] [INFO] listener_6\n [pid: 1111111] [INFO] listener_5\n [pid: 1111111] [INFO] listener_8\n [pid: 1111111] [INFO] listener_7\n [pid: 1000000] [INFO] listener_9\n [pid: 1000000] [INFO] Server Stopped\n ```\n In the above example, notice how there are three processes running:\n\n - `pid: 1000000` - The *main* process\n - `pid: 1111111` - Worker 1\n - `pid: 1222222` - Worker 2\n\n *Just because our example groups all of one worker and then all of another, in reality since these are running on separate processes, the ordering between processes is not guaranteed. But, you can be sure that a single worker will **always** maintain its order.*\n\n\n\n.. tip:: FYI\n\n The practical result of this is that if the first listener in `before_server_start` handler setups a database connection, listeners that are registered after it can rely upon that connection being alive both when they are started and stopped.\n\n### Priority\n\nIn v23.12, the `priority` keyword argument was added to listeners. This allows for fine-tuning the order of execution of listeners. The default priority is `0`. Listeners with a higher priority will be executed first. Listeners with the same priority will be executed in the order they were registered. Furthermore, listeners attached to the `app` instance will be executed before listeners attached to a `Blueprint` instance.\n\t\nOverall the rules for deciding the order of execution are as follows:\n\n1. Priority in descending order\n2. Application listeners before Blueprint listeners\n3. Registration order\n\n.. column::\n\n As an example, consider the following, which will print:\n\n ```bash\n third\n bp_third\n second\n bp_second\n first\n fourth\n bp_first\n ```\n\n.. column::\n\n ```python\n @app.before_server_start\n async def first(app):\n print(\"first\")\n\n @app.listener(\"before_server_start\", priority=2)\n async def second(app):\n print(\"second\")\n\n @app.before_server_start(priority=3)\n async def third(app):\n print(\"third\")\n\n @bp.before_server_start\n async def bp_first(app):\n print(\"bp_first\")\n\n @bp.listener(\"before_server_start\", priority=2)\n async def bp_second(app):\n print(\"bp_second\")\n\n @bp.before_server_start(priority=3)\n async def bp_third(app):\n print(\"bp_third\")\n\n @app.before_server_start\n async def fourth(app):\n print(\"fourth\")\n\n app.blueprint(bp)\n ```\n\n## ASGI Mode\n\nIf you are running your application with an ASGI server, then make note of the following changes:\n\n- `reload_process_start` and `reload_process_stop` will be **ignored**\n- `main_process_start` and `main_process_stop` will be **ignored**\n- `before_server_start` will run as early as it can, and will be before `after_server_start`, but technically, the server is already running at that point\n- `after_server_stop` will run as late as it can, and will be after `before_server_stop`, but technically, the server is still running at that point\n" }, { "path": "guide/content/en/guide/basics/middleware.md", "content": "# Middleware\n\nWhereas listeners allow you to attach functionality to the lifecycle of a worker process, middleware allows you to attach functionality to the lifecycle of an HTTP stream.\n\n```python\n@app.on_request\nasync def example(request):\n\tprint(\"I execute before the handler.\")\n```\n\nYou can execute middleware either _before_ the handler is executed, or _after_.\n\n```python\n@app.on_response\nasync def example(request, response):\n\tprint(\"I execute after the handler.\")\n```\n\n.. mermaid::\n\n sequenceDiagram\n autonumber\n participant Worker\n participant Middleware\n participant MiddlewareHandler\n participant RouteHandler\n Note over Worker: Incoming HTTP request\n loop\n Worker->>Middleware: @app.on_request\n Middleware->>MiddlewareHandler: Invoke middleware handler\n MiddlewareHandler-->>Worker: Return response (optional)\n end\n rect rgba(255, 13, 104, .1)\n Worker->>RouteHandler: Invoke route handler\n RouteHandler->>Worker: Return response\n end\n loop\n Worker->>Middleware: @app.on_response\n Middleware->>MiddlewareHandler: Invoke middleware handler\n MiddlewareHandler-->>Worker: Return response (optional)\n end\n Note over Worker: Deliver response\n\n## Attaching middleware\n\n.. column::\n\n This should probably look familiar by now. All you need to do is declare when you would like the middleware to execute: on the `request` or on the `response`.\n\n.. column::\n\n ```python\n async def extract_user(request):\n request.ctx.user = await extract_user_from_request(request)\n\n app.register_middleware(extract_user, \"request\")\n ```\n\n.. column::\n\n Again, the `Sanic` app instance also has a convenience decorator.\n\n.. column::\n\n ```python\n @app.middleware(\"request\")\n async def extract_user(request):\n request.ctx.user = await extract_user_from_request(request)\n ```\n\n.. column::\n\n Response middleware receives both the `request` and `response` arguments.\n\n.. column::\n\n ```python\n @app.middleware('response')\n async def prevent_xss(request, response):\n response.headers[\"x-xss-protection\"] = \"1; mode=block\"\n ```\n\n.. column::\n\n You can shorten the decorator even further. This is helpful if you have an IDE with autocomplete.\n\n This is the preferred usage, and is what we will use going forward.\n\n.. column::\n\n ```python\n @app.on_request\n async def extract_user(request):\n ...\n\n @app.on_response\n async def prevent_xss(request, response):\n ...\n ```\n\n## Modification\n\nMiddleware can modify the request or response parameter it is given, _as long as it does not return it_.\n\n\n.. column::\n\n #### Order of execution\n\n 1. Request middleware: `add_key`\n 2. Route handler: `index`\n 3. Response middleware: `prevent_xss`\n 4. Response middleware: `custom_banner`\n\n.. column::\n\n ```python\n @app.on_request\n async def add_key(request):\n # Arbitrary data may be stored in request context:\n request.ctx.foo = \"bar\"\n\n @app.on_response\n async def custom_banner(request, response):\n response.headers[\"Server\"] = \"Fake-Server\"\n\n @app.on_response\n async def prevent_xss(request, response):\n response.headers[\"x-xss-protection\"] = \"1; mode=block\"\n\n @app.get(\"/\")\n async def index(request):\n return text(request.ctx.foo)\n\n ```\n\n.. column::\n\n You can modify the `request.match_info`. A useful feature that could be used, for example, in middleware to convert `a-slug` to `a_slug`.\n\n.. column::\n\n ```python\n @app.on_request\n def convert_slug_to_underscore(request: Request):\n request.match_info[\"slug\"] = request.match_info[\"slug\"].replace(\"-\", \"_\")\n\n @app.get(\"/\")\n async def handler(request, slug):\n return text(slug)\n ```\n ```\n $ curl localhost:9999/foo-bar-baz\n foo_bar_baz\n ```\n\n## Responding early\n\n.. column::\n\n If middleware returns a `HTTPResponse` object, the request will stop processing and the response will be returned. If this occurs to a request before the route handler is reached, the handler will **not** be called. Returning a response will also prevent any further middleware from running.\n\n \n\n.. tip:: \n\n You can return a `None` value to stop the execution of the middleware handler to allow the request to process as normal. This can be useful when using early return to avoid processing requests inside of that middleware handler.\n\n.. column::\n\n ```python\n @app.on_request\n async def halt_request(request):\n return text(\"I halted the request\")\n\n @app.on_response\n async def halt_response(request, response):\n return text(\"I halted the response\")\n ```\n\n## Order of execution\n\nRequest middleware is executed in the order declared. Response middleware is executed in **reverse order**.\n\nGiven the following setup, we should expect to see this in the console.\n\n.. column::\n\n ```python\n @app.on_request\n async def middleware_1(request):\n print(\"middleware_1\")\n\n @app.on_request\n async def middleware_2(request):\n print(\"middleware_2\")\n\n @app.on_response\n async def middleware_3(request, response):\n print(\"middleware_3\")\n\n @app.on_response\n async def middleware_4(request, response):\n print(\"middleware_4\")\n \n @app.get(\"/handler\")\n async def handler(request):\n print(\"~ handler ~\")\n return text(\"Done.\")\n ```\n\n.. column::\n\n ```bash\n middleware_1\n middleware_2\n ~ handler ~\n middleware_4\n middleware_3\n [INFO][127.0.0.1:44788]: GET http://localhost:8000/handler 200 5\n ```\n\n### Middleware priority\n\n.. column::\n\n You can modify the order of execution of middleware by assigning it a higher priority. This happens inside of the middleware definition. The higher the value, the earlier it will execute relative to other middleware. The default priority for middleware is `0`.\n\n.. column::\n\n ```python\n @app.on_request\n async def low_priority(request):\n ...\n\n @app.on_request(priority=99)\n async def high_priority(request):\n ...\n ```\n\n*Added in v22.9*\n" }, { "path": "guide/content/en/guide/basics/request.md", "content": "# Request\n\nSee API docs: [sanic.request](/api/sanic.request)\n\nThe :class:`sanic.request.Request` instance contains **a lot** of helpful information available on its parameters. Refer to the [API documentation](https://sanic.readthedocs.io/) for full details.\n\nAs we saw in the section on [handlers](./handlers.md), the first argument in a route handler is usually the :class:`sanic.request.Request` object. Because Sanic is an async framework, the handler will run inside of a [`asyncio.Task`](https://docs.python.org/3/library/asyncio-task.html#asyncio.Task) and will be scheduled by the event loop. This means that the handler will be executed in an isolated context and the request object will be unique to that handler's task.\n\n.. column::\n\n By convention, the argument is named `request`, but you can name it whatever you want. The name of the argument is not important. Both of the following handlers are valid.\n \n.. column::\n\n ```python\n @app.get(\"/foo\")\n async def typical_use_case(request):\n return text(\"I said foo!\")\n ```\n\n ```python\n @app.get(\"/foo\")\n async def atypical_use_case(req):\n return text(\"I said foo!\")\n ```\n\n.. column::\n\n Annotating a request object is super simple.\n \n.. column::\n\n ```python\n from sanic.request import Request\n from sanic.response import text\n\n @app.get(\"/typed\")\n async def typed_handler(request: Request):\n return text(\"Done.\")\n ```\n\n.. tip::\n \n For your convenience, assuming you are using a modern IDE, you should leverage type annotations to help with code completion and documentation. This is especially helpful when using the `request` object as it has **MANY** properties and methods.\n \n To see the full list of available properties and methods, refer to the [API documentation](/api/sanic.request).\n\n## Body\n\nThe `Request` object allows you to access the content of the request body in a few different ways.\n\n### JSON\n\n.. column::\n\n **Parameter**: `request.json` \n **Description**: The parsed JSON object\n\n.. column::\n\n ```bash\n $ curl localhost:8000 -d '{\"foo\": \"bar\"}'\n ```\n\n ```python\n >>> print(request.json)\n {'foo': 'bar'}\n ```\n\n### Raw\n\n.. column::\n\n **Parameter**: `request.body` \n **Description**: The raw bytes from the request body\n\n.. column::\n\n ```bash\n $ curl localhost:8000 -d '{\"foo\": \"bar\"}'\n ```\n\n ```python\n >>> print(request.body)\n b'{\"foo\": \"bar\"}'\n ```\n\n### Form\n\n.. column::\n\n **Parameter**: `request.form` \n **Description**: The form data\n\n .. tip:: FYI\n\n The `request.form` object is one of a few types that is a dictionary with each value being a list. This is because HTTP allows a single key to be reused to send multiple values. \n\n Most of the time you will want to use the `.get()` method to access the first element and not a list. If you do want a list of all items, you can use `.getlist()`.\n\n.. column::\n\n ```bash\n $ curl localhost:8000 -d 'foo=bar'\n ```\n\n ```python\n >>> print(request.body)\n b'foo=bar'\n\n >>> print(request.form)\n {'foo': ['bar']}\n\n >>> print(request.form.get(\"foo\"))\n bar\n\n >>> print(request.form.getlist(\"foo\"))\n ['bar']\n ```\n\n### Uploaded\n\n.. column::\n\n **Parameter**: `request.files` \n **Description**: The files uploaded to the server\n\n .. tip:: FYI\n\n The `request.files` object is one of a few types that is a dictionary with each value being a list. This is because HTTP allows a single key to be reused to send multiple values. \n\n Most of the time you will want to use the `.get()` method to access the first element and not a list. If you do want a list of all items, you can use `.getlist()`.\n\n.. column::\n\n ```bash\n $ curl -F 'my_file=@/path/to/TEST' http://localhost:8000\n ```\n\n ```python\n >>> print(request.body)\n b'--------------------------cb566ad845ad02d3\\r\\nContent-Disposition: form-data; name=\"my_file\"; filename=\"TEST\"\\r\\nContent-Type: application/octet-stream\\r\\n\\r\\nhello\\n\\r\\n--------------------------cb566ad845ad02d3--\\r\\n'\n\n >>> print(request.files)\n {'my_file': [File(type='application/octet-stream', body=b'hello\\n', name='TEST')]}\n\n >>> print(request.files.get(\"my_file\"))\n File(type='application/octet-stream', body=b'hello\\n', name='TEST')\n\n >>> print(request.files.getlist(\"my_file\"))\n [File(type='application/octet-stream', body=b'hello\\n', name='TEST')]\n ```\n\n## Context\n\n### Request context\n\nThe `request.ctx` object is your playground to store whatever information you need to about the request. This lives only for the duration of the request and is unique to the request.\n\nThis can be constrasted with the `app.ctx` object which is shared across all requests. Be careful not to confuse them! \n\nThe `request.ctx` object by default is a `SimpleNamespace` object allowing you to set arbitrary attributes on it. Sanic will not use this object for anything, so you are free to use it however you want without worrying about name clashes.\n\n### Typical use case\n\nThis is often used to store items like authenticated user details. We will get more into [middleware](./middleware.md) later, but here is a simple example.\n\n```python\n@app.on_request\nasync def run_before_handler(request):\n request.ctx.user = await fetch_user_by_token(request.token)\n\n@app.route('/hi')\nasync def hi_my_name_is(request):\n if not request.ctx.user:\n return text(\"Hmm... I don't know you)\n return text(f\"Hi, my name is {request.ctx.user.name}\")\n```\n\nAs you can see, the `request.ctx` object is a great place to store information that you need to access in multiple handlers making your code more DRY and easier to maintain. But, as we will learn in the [middleware section](./middleware.md), you can also use it to store information from one middleware that will be used in another.\n\n### Connection context\n\n.. column::\n\n Often times your API will need to serve multiple concurrent (or consecutive) requests to the same client. This happens, for example, very often with progressive web apps that need to query multiple endpoints to get data.\n\n The HTTP protocol calls for an easing of overhead time caused by the connection with the use of [keep alive headers](../running/configuration.md#keep-alive-timeout).\n\n When multiple requests share a single connection, Sanic provides a context object to allow those requests to share state.\n\n.. column::\n\n ```python\n @app.on_request\n async def increment_foo(request):\n if not hasattr(request.conn_info.ctx, \"foo\"):\n request.conn_info.ctx.foo = 0\n request.conn_info.ctx.foo += 1\n\n @app.get(\"/\")\n async def count_foo(request):\n return text(f\"request.conn_info.ctx.foo={request.conn_info.ctx.foo}\")\n ```\n\n ```bash\n $ curl localhost:8000 localhost:8000 localhost:8000\n request.conn_info.ctx.foo=1\n request.conn_info.ctx.foo=2\n request.conn_info.ctx.foo=3\n ```\n\n.. warning::\n\n While this looks like a convenient place to store information between requests by a single HTTP connection, do not assume that all requests on a single connection came from a single end user. This is because HTTP proxies and load balancers can multiplex multiple connections into a single connection to your server.\n \n **DO NOT** use this to store information about a single user. Use the `request.ctx` object for that.\n\n### Custom Request Objects\n\nAs discussed in [application customization](./app.md#custom-requests), you can create a subclass of :class:`sanic.request.Request` to add additional functionality to the request object. This is useful for adding additional attributes or methods that are specific to your application.\n\n.. column::\n\n For example, imagine your application sends a custom header that contains a user ID. You can create a custom request object that will parse that header and store the user ID for you.\n\n.. column::\n\n ```python\n from sanic import Sanic, Request\n\n class CustomRequest(Request):\n def __init__(self, *args, **kwargs):\n super().__init__(*args, **kwargs)\n self.user_id = self.headers.get(\"X-User-ID\")\n\n app = Sanic(\"Example\", request_class=CustomRequest)\n ```\n\n\n.. column::\n\n Now, in your handlers, you can access the `user_id` attribute.\n\n.. column::\n\n ```python\n @app.route(\"/\")\n async def handler(request: CustomRequest):\n return text(f\"User ID: {request.user_id}\")\n ```\n\n\n### Custom Request Context\n\nBy default, the request context (`request.ctx`) is a [`Simplenamespace`](https://docs.python.org/3/library/types.html#types.SimpleNamespace) object allowing you to set arbitrary attributes on it. While this is super helpful to reuse logic across your application, it can be difficult in the development experience since the IDE will not know what attributes are available.\n\nTo help with this, you can create a custom request context object that will be used instead of the default `SimpleNamespace`. This allows you to add type hints to the context object and have them be available in your IDE.\n\n.. column::\n\n Start by subclassing the :class:`sanic.request.Request` class to create a custom request type. Then, you will need to add a `make_context()` method that returns an instance of your custom context object. *NOTE: the `make_context` method should be a static method.*\n\n.. column::\n\n ```python\n from sanic import Sanic, Request\n from types import SimpleNamespace\n\n class CustomRequest(Request):\n def __init__(self, *args, **kwargs):\n super().__init__(*args, **kwargs)\n self.ctx.user_id = self.headers.get(\"X-User-ID\")\n\n @staticmethod\n def make_context() -> CustomContext:\n return CustomContext()\n\n @dataclass\n class CustomContext:\n user_id: str = None\n ```\n\n.. note::\n\n This is a Sanic poweruser feature that makes it super convenient in large codebases to have typed request context objects. It is of course not required, but can be very helpful.\n\n*Added in v23.6*\n\n\n## Parameters\n\n.. column::\n\n Values that are extracted from the path parameters are injected into the handler as argumets, or more specifically as keyword arguments. There is much more detail about this in the [Routing section](./routing.md).\n\n.. column::\n\n ```python\n @app.route('/tag/')\n async def tag_handler(request, tag):\n return text(\"Tag - {}\".format(tag))\n \n # or, explicitly as keyword arguments\n @app.route('/tag/')\n async def tag_handler(request, *, tag):\n return text(\"Tag - {}\".format(tag))\n ```\n\n\n## Arguments\n\nThere are two attributes on the `request` instance to get query parameters:\n\n- `request.args`\n- `request.query_args`\n\nThese allow you to access the query parameters from the request path (the part after the `?` in the URL).\n\n### Typical use case\n\nIn most use cases, you will want to use the `request.args` object to access the query parameters. This will be the parsed query string as a dictionary.\n\nThis is by far the most common pattern.\n\n.. column::\n\n Consider the example where we have a `/search` endpoint with a `q` parameter that we want to use to search for something.\n\n.. column::\n\n ```python\n @app.get(\"/search\")\n async def search(request):\n query = request.args.get(\"q\")\n if not query:\n return text(\"No query string provided\")\n return text(f\"Searching for: {query}\")\n ```\n\n### Parsing the query string\n\nSometimes, however, you may want to access the query string as a raw string or as a list of tuples. For this, you can use the `request.query_string` and `request.query_args` attributes. \n\nIt also should be noted that HTTP allows multiple values for a single key. Although `request.args` may seem like a regular dictionary, it is actually a special type that allows for multiple values for a single key. You can access this by using the `request.args.getlist()` method.\n\n- `request.query_string` - The raw query string\n- `request.query_args` - The parsed query string as a list of tuples\n- `request.args` - The parsed query string as a *special* dictionary\n - `request.args.get()` - Get the first value for a key (behaves like a regular dictionary)\n - `request.args.getlist()` - Get all values for a key\n\n```sh\ncurl \"http://localhost:8000?key1=val1&key2=val2&key1=val3\"\n```\n\n```python\n>>> print(request.args)\n{'key1': ['val1', 'val3'], 'key2': ['val2']}\n\n>>> print(request.args.get(\"key1\"))\nval1\n\n>>> print(request.args.getlist(\"key1\"))\n['val1', 'val3']\n\n>>> print(request.query_args)\n[('key1', 'val1'), ('key2', 'val2'), ('key1', 'val3')]\n\n>>> print(request.query_string)\nkey1=val1&key2=val2&key1=val3\n\n```\n\n\n.. tip:: FYI\n\n The `request.args` object is one of a few types that is a dictionary with each value being a list. This is because HTTP allows a single key to be reused to send multiple values. \n\n Most of the time you will want to use the `.get()` method to access the first element and not a list. If you do want a list of all items, you can use `.getlist()`.\n\n## Current request getter\n\nSometimes you may find that you need access to the current request in your application in a location where it is not accessible. A typical example might be in a `logging` format. You can use `Request.get_current()` to fetch the current request (if any).\n\nRemember, the request object is confined to the single [`asyncio.Task`](https://docs.python.org/3/library/asyncio-task.html#asyncio.Task) that is running the handler. If you are not in that task, there is no request object.\n\n```python\nimport logging\n\nfrom sanic import Request, Sanic, json\nfrom sanic.exceptions import SanicException\nfrom sanic.log import LOGGING_CONFIG_DEFAULTS\n\nLOGGING_FORMAT = (\n \"%(asctime)s - (%(name)s)[%(levelname)s][%(host)s]: \"\n \"%(request_id)s %(request)s %(message)s %(status)d %(byte)d\"\n)\n\nold_factory = logging.getLogRecordFactory()\n\ndef record_factory(*args, **kwargs):\n record = old_factory(*args, **kwargs)\n record.request_id = \"\"\n\n try:\n request = Request.get_current()\n except SanicException:\n ...\n else:\n record.request_id = str(request.id)\n\n return record\n\nlogging.setLogRecordFactory(record_factory)\n\n\nLOGGING_CONFIG_DEFAULTS[\"formatters\"][\"access\"][\"format\"] = LOGGING_FORMAT\napp = Sanic(\"Example\", log_config=LOGGING_CONFIG_DEFAULTS)\n```\n\nIn this example, we are adding the `request.id` to every access log message.\n\n*Added in v22.6*\n" }, { "path": "guide/content/en/guide/basics/response.md", "content": "# Response\n\nAll [handlers](./handlers.md) *usually* return a response object, and [middleware](./middleware.md) may optionally return a response object.\n\nTo clarify that statement:\n- unless the handler is a streaming endpoint handling its own pattern for sending bytes to the client, the return value must be an instance of :class:`sanic.response.HTTPResponse` (to learn more about this exception see [streaming responses](../advanced/streaming.md#response-streaming)). In **most** use cases, you will need to return a response.\n- if a middleware does return a response object, that will be used instead of whatever the handler would do (see [middleware](./middleware.md) to learn more).\n\nA most basic handler would look like the following. The :class:`sanic.response.HTTPResponse` object will allow you to set the status, body, and headers to be returned to the client.\n\n```python\nfrom sanic import HTTPResponse, Sanic\n\napp = Sanic(\"TestApp\")\n\n@app.route(\"\")\ndef handler(_):\n return HTTPResponse()\n```\n\nHowever, usually it is easier to use one of the convenience methods discussed below.\n\n## Methods\n\nThe easiest way to generate a response object is to use one of the convenience functions.\n\n### Text\n\n.. column::\n\n **Default Content-Type**: `text/plain; charset=utf-8` \n **Description**: Returns plain text\n\n.. column::\n\n ```python\n from sanic import text\n\n @app.route(\"/\")\n async def handler(request):\n return text(\"Hi 😎\")\n ```\n\n### HTML\n\n.. column::\n\n **Default Content-Type**: `text/html; charset=utf-8` \n **Description**: Returns an HTML document\n\n.. column::\n\n ```python\n from sanic import html\n\n @app.route(\"/\")\n async def handler(request):\n return html('
Hi 😎
')\n ```\n\n### JSON\n\n.. column::\n\n **Default Content-Type**: `application/json` \n **Description**: Returns a JSON document\n\n.. column::\n\n ```python\n from sanic import json\n\n @app.route(\"/\")\n async def handler(request):\n return json({\"foo\": \"bar\"})\n ```\n\nBy default, Sanic ships with [`ujson`](https://github.com/ultrajson/ultrajson) as its JSON encoder of choice. If `ujson` is not installed, it will fall back to the standard library `json` module.\n\nIt is super simple to change this if you want.\n\n```python\nfrom sanic import json\nfrom orjson import dumps\n\njson({\"foo\": \"bar\"}, dumps=dumps)\n```\n\nYou may additionally declare which implementation to use globally across your application at initialization:\n\n```python\nfrom orjson import dumps\n\napp = Sanic(..., dumps=dumps)\n```\n\n### File\n\n.. column::\n\n **Default Content-Type**: N/A \n **Description**: Returns a file\n\n.. column::\n\n ```python\n from sanic import file\n\n @app.route(\"/\")\n async def handler(request):\n return await file(\"/path/to/whatever.png\")\n ```\n\nSanic will examine the file, and try and guess its mime type and use an appropriate value for the content type. You could be explicit, if you would like:\n\n```python\nfile(\"/path/to/whatever.png\", mime_type=\"image/png\")\n```\n\nYou can also choose to override the file name:\n\n```python\nfile(\"/path/to/whatever.png\", filename=\"super-awesome-incredible.png\")\n```\n\n### File Streaming\n\n.. column::\n\n **Default Content-Type**: N/A \n **Description**: Streams a file to a client, useful when streaming large files, like a video\n\n.. column::\n\n ```python\n from sanic.response import file_stream\n\n @app.route(\"/\")\n async def handler(request):\n return await file_stream(\"/path/to/whatever.mp4\")\n ```\n\nLike the `file()` method, `file_stream()` will attempt to determine the mime type of the file.\n\n\n\n### Raw\n\n.. column::\n\n **Default Content-Type**: `application/octet-stream` \n **Description**: Send raw bytes without encoding the body\n\n.. column::\n\n ```python\n from sanic import raw\n\n @app.route(\"/\")\n async def handler(request):\n return raw(b\"raw bytes\")\n ```\n\n### Redirect\n\n.. column::\n\n **Default Content-Type**: `text/html; charset=utf-8` \n **Description**: Send a `302` response to redirect the client to a different path\n\n.. column::\n\n ```python\n from sanic import redirect\n\n @app.route(\"/\")\n async def handler(request):\n return redirect(\"/login\")\n ```\n\n### Empty\n\n.. column::\n\n **Default Content-Type**: N/A \n **Description**: For responding with an empty message as defined by [RFC 2616](https://tools.ietf.org/search/rfc2616#section-7.2.1)\n\n.. column::\n\n ```python\n from sanic import empty\n\n @app.route(\"/\")\n async def handler(request):\n return empty()\n ```\n\n Defaults to a `204` status.\n\n## Default status\n\nThe default HTTP status code for the response is `200`. If you need to change it, it can be done by the response method.\n\n```python\n@app.post(\"/\")\nasync def create_new(request):\n new_thing = await do_create(request)\n return json({\"created\": True, \"id\": new_thing.thing_id}, status=201)\n```\n\n## Returning JSON data\n\nStarting in v22.12, When you use the `sanic.json` convenience method, it will return a subclass of `HTTPResponse` called :class:`sanic.response.types.JSONResponse`. This object will \nhave several convenient methods available to modify common JSON body.\n\n```python\nfrom sanic import json\n\nresp = json(...)\n```\n\n- `resp.set_body()` - Set the body of the JSON object to the value passed\n- `resp.append()` - Append a value to the body like `list.append` (only works if the root JSON is an array)\n- `resp.extend()` - Extend a value to the body like `list.extend` (only works if the root JSON is an array)\n- `resp.update()` - Update the body with a value like `dict.update` (only works if the root JSON is an object)\n- `resp.pop()` - Pop a value like `list.pop` or `dict.pop` (only works if the root JSON is an array or an object)\n\n.. warning::\n\n The raw Python object is stored on the `JSONResponse` object as `raw_body`. While it is safe to overwrite this value with a new one, you should **not** attempt to mutate it. You should instead use the methods listed above.\n\n```python\nresp = json({\"foo\": \"bar\"})\n\n# This is OKAY\nresp.raw_body = {\"foo\": \"bar\", \"something\": \"else\"}\n\n# This is better\nresp.set_body({\"foo\": \"bar\", \"something\": \"else\"})\n\n# This is also works well\nresp.update({\"something\": \"else\"})\n\n# This is NOT OKAY\nresp.raw_body.update({\"something\": \"else\"})\n```\n\n```python\n# Or, even treat it like a list\nresp = json([\"foo\", \"bar\"])\n\n# This is OKAY\nresp.raw_body = [\"foo\", \"bar\", \"something\", \"else\"]\n\n# This is better\nresp.extend([\"something\", \"else\"])\n\n# This is also works well\nresp.append(\"something\")\nresp.append(\"else\")\n\n# This is NOT OKAY\nresp.raw_body.append(\"something\")\n```\n\n*Added in v22.9*\n" }, { "path": "guide/content/en/guide/basics/routing.md", "content": "# Routing\n\n.. column::\n\n So far we have seen a lot of this decorator in different forms.\n\n But what is it? And how do we use it?\n\n.. column::\n\n ```python\n @app.route(\"/stairway\")\n ...\n\n @app.get(\"/to\")\n ...\n\n @app.post(\"/heaven\")\n ...\n ```\n\n## Adding a route\n\n.. column::\n\n The most basic way to wire up a handler to an endpoint is with `app.add_route()`.\n\n See [API docs](https://sanic.readthedocs.io/en/stable/sanic/api_reference.html#sanic.app.Sanic.url_for) for more details.\n\n.. column::\n\n ```python\n async def handler(request):\n return text(\"OK\")\n\n app.add_route(handler, \"/test\")\n ```\n\n\n.. column::\n\n By default, routes are available as an HTTP `GET` call. You can change a handler to respond to one or more HTTP methods.\n\n.. column::\n\n ```python\n app.add_route(\n handler,\n '/test',\n methods=[\"POST\", \"PUT\"],\n )\n ```\n\n\n.. column::\n\n Using the decorator syntax, the previous example is identical to this.\n\n.. column::\n\n ```python\n @app.route('/test', methods=[\"POST\", \"PUT\"])\n async def handler(request):\n return text('OK')\n ```\n\n## HTTP methods\n\nEach of the standard HTTP methods has a convenience decorator.\n\n### GET\n\n```python\n@app.get('/test')\nasync def handler(request):\n return text('OK')\n```\n\n[MDN Docs](https://developer.mozilla.org/en-US/docs/Web/HTTP/Methods/GET)\n\n### POST\n\n```python\n@app.post('/test')\nasync def handler(request):\n return text('OK')\n```\n\n[MDN Docs](https://developer.mozilla.org/en-US/docs/Web/HTTP/Methods/POST)\n\n### PUT\n\n```python\n@app.put('/test')\nasync def handler(request):\n return text('OK')\n```\n\n[MDN Docs](https://developer.mozilla.org/en-US/docs/Web/HTTP/Methods/PUT)\n\n### PATCH\n\n```python\n@app.patch('/test')\nasync def handler(request):\n return text('OK')\n```\n\n[MDN Docs](https://developer.mozilla.org/en-US/docs/Web/HTTP/Methods/PATCH)\n\n### DELETE\n\n```python\n@app.delete('/test')\nasync def handler(request):\n return text('OK')\n```\n\n[MDN Docs](https://developer.mozilla.org/en-US/docs/Web/HTTP/Methods/DELETE)\n\n### HEAD\n\n```python\n@app.head('/test')\nasync def handler(request):\n return empty()\n```\n\n[MDN Docs](https://developer.mozilla.org/en-US/docs/Web/HTTP/Methods/HEAD)\n\n### OPTIONS\n\n```python\n@app.options('/test')\nasync def handler(request):\n return empty()\n```\n\n[MDN Docs](https://developer.mozilla.org/en-US/docs/Web/HTTP/Methods/OPTIONS)\n\n\n.. warning:: \n\n By default, Sanic will **only** consume the incoming request body on non-safe HTTP methods: `POST`, `PUT`, `PATCH`, `DELETE`. If you want to receive data in the HTTP request on any other method, you will need to do one of the following two options:\n\n **Option #1 - Tell Sanic to consume the body using `ignore_body`**\n ```python\n @app.request(\"/path\", ignore_body=False)\n async def handler(_):\n ...\n ```\n\n **Option #2 - Manually consume the body in the handler using `receive_body`**\n ```python\n @app.get(\"/path\")\n async def handler(request: Request):\n await request.receive_body()\n ```\n\n\n## Path parameters\n\n.. column::\n\n Sanic allows for pattern matching, and for extracting values from URL paths. These parameters are then injected as keyword arguments in the route handler.\n\n.. column::\n\n ```python\n @app.get(\"/tag/\")\n async def tag_handler(request, tag):\n return text(\"Tag - {}\".format(tag))\n ```\n\n.. column::\n\n You can declare a type for the parameter. This will be enforced when matching, and also will type cast the variable.\n\n.. column::\n\n ```python\n @app.get(\"/foo/\")\n async def uuid_handler(request, foo_id: UUID):\n return text(\"UUID - {}\".format(foo_id))\n ```\n\n.. column::\n\n For some standard types like `str`, `int`, and `UUID`, Sanic can infer the path parameter type from the function signature. This means that it may not always be necessary to include the type in the path parameter definition.\n\n.. column::\n\n ```python\n @app.get(\"/foo/\") # Notice there is no :uuid in the path parameter\n async def uuid_handler(request, foo_id: UUID):\n return text(\"UUID - {}\".format(foo_id))\n ```\n\n### Supported types\n\n### `str`\n\n.. column::\n\n **Regular expression applied**: `r\"[^/]+\"` \n **Cast type**: `str` \n **Example matches**: \n\n - `/path/to/Bob`\n - `/path/to/Python%203`\n\n Beginning in v22.3 `str` will *not* match on empty strings. See `strorempty` for this behavior.\n\n.. column::\n\n ```python\n @app.route(\"/path/to/\")\n async def handler(request, foo: str):\n ...\n ```\n\n### `strorempty`\n\n.. column::\n\n **Regular expression applied**: `r\"[^/]*\"` \n **Cast type**: `str` \n **Example matches**:\n\n - `/path/to/Bob`\n - `/path/to/Python%203`\n - `/path/to/`\n\n Unlike the `str` path parameter type, `strorempty` can also match on an empty string path segment.\n\n *Added in v22.3*\n\n.. column::\n\n ```python\n @app.route(\"/path/to/\")\n async def handler(request, foo: str):\n ...\n ```\n\n### `int`\n\n.. column::\n\n **Regular expression applied**: `r\"-?\\d+\"` \n **Cast type**: `int` \n **Example matches**: \n\n - `/path/to/10`\n - `/path/to/-10`\n\n _Does not match float, hex, octal, etc_\n\n.. column::\n\n ```python\n @app.route(\"/path/to/\")\n async def handler(request, foo: int):\n ...\n ```\n\n### `float`\n\n.. column::\n\n **Regular expression applied**: `r\"-?(?:\\d+(?:\\.\\d*)?|\\.\\d+)\"` \n **Cast type**: `float` \n **Example matches**: \n\n - `/path/to/10`\n - `/path/to/-10`\n - `/path/to/1.5`\n\n.. column::\n\n ```python\n @app.route(\"/path/to/\")\n async def handler(request, foo: float):\n ...\n ```\n\n### `alpha`\n\n.. column::\n\n **Regular expression applied**: `r\"[A-Za-z]+\"` \n **Cast type**: `str` \n **Example matches**: \n\n - `/path/to/Bob`\n - `/path/to/Python`\n\n _Does not match a digit, or a space or other special character_\n\n.. column::\n\n ```python\n @app.route(\"/path/to/\")\n async def handler(request, foo: str):\n ...\n ```\n\n### `slug`\n\n.. column::\n\n **Regular expression applied**: `r\"[a-z0-9]+(?:-[a-z0-9]+)*\"` \n **Cast type**: `str` \n **Example matches**: \n\n - `/path/to/some-news-story`\n - `/path/to/or-has-digits-123`\n\n *Added in v21.6*\n\n.. column::\n\n\n ```python\n @app.route(\"/path/to/\")\n async def handler(request, article: str):\n ...\n ```\n\n### `path`\n\n.. column::\n\n **Regular expression applied**: `r\"[^/].*?\"` \n **Cast type**: `str` \n **Example matches**:\n - `/path/to/hello`\n - `/path/to/hello.txt`\n - `/path/to/hello/world.txt`\n\n\n.. column::\n\n ```python\n @app.route(\"/path/to/\")\n async def handler(request, foo: str):\n ...\n ```\n.. warning::\n\n Because this will match on `/`, you should be careful and thoroughly test your patterns that use `path` so they do not capture traffic intended for another endpoint. Additionally, depending on how you use this type, you may be creating a path traversal vulnerability in your application. It is your job to protect your endpoint against this, but feel free to ask in our community channels for help if you need it :)\n\n### `ymd`\n\n.. column::\n\n **Regular expression applied**: `r\"^([12]\\d{3}-(0[1-9]|1[0-2])-(0[1-9]|[12]\\d|3[01]))\"` \n **Cast type**: `datetime.date` \n **Example matches**: \n\n - `/path/to/2021-03-28`\n\n.. column::\n\n ```python\n @app.route(\"/path/to/\")\n async def handler(request, foo: datetime.date):\n ...\n ```\n\n### `uuid`\n\n.. column::\n\n **Regular expression applied**: `r\"[A-Fa-f0-9]{8}-[A-Fa-f0-9]{4}-[A-Fa-f0-9]{4}-[A-Fa-f0-9]{4}-[A-Fa-f0-9]{12}\"` \n **Cast type**: `UUID` \n **Example matches**: \n\n - `/path/to/123a123a-a12a-1a1a-a1a1-1a12a1a12345`\n\n.. column::\n\n ```python\n @app.route(\"/path/to/\")\n async def handler(request, foo: UUID):\n ...\n ```\n\n### ext\n\n.. column::\n\n **Regular expression applied**: n/a\n **Cast type**: *varies*\n **Example matches**:\n\n.. column::\n\n ```python\n @app.route(\"/path/to/\")\n async def handler(request, foo: str, ext: str):\n ...\n ```\n\n| definition | example | filename | extension |\n| --------------------------------- | ----------- | ----------- | ---------- |\n| \\ | page.txt | `\"page\"` | `\"txt\"` |\n| \\ | cat.jpg | `\"cat\"` | `\"jpg\"` |\n| \\ | cat.jpg | `\"cat\"` | `\"jpg\"` |\n| | 123.txt | `123` | `\"txt\"` |\n| | 123.svg | `123` | `\"svg\"` |\n| | 3.14.tar.gz | `3.14` | `\"tar.gz\"` |\n\nFile extensions can be matched using the special `ext` parameter type. It uses a special format that allows you to specify other types of parameter types as the file name, and one or more specific extensions as shown in the example table above.\n\nIt does *not* support the `path` parameter type.\n\n*Added in v22.3*\n\n### regex\n\n.. column::\n\n **Regular expression applied**: _whatever you insert_ \n **Cast type**: `str` \n **Example matches**: \n\n - `/path/to/2021-01-01`\n\n This gives you the freedom to define specific matching patterns for your use case.\n\n In the example shown, we are looking for a date that is in `YYYY-MM-DD` format.\n\n.. column::\n\n ```python\n @app.route(r\"/path/to/\")\n async def handler(request, foo: str):\n ...\n ```\n\n### Regex Matching\n\n\nMore often than not, compared with complex routing, the above example is too simple, and we use a completely different routing matching pattern, so here we will explain the advanced usage of regex matching in detail.\n\nSometimes, you want to match a part of a route:\n\n```text\n/image/123456789.jpg\n```\n\nIf you wanted to match the file pattern, but only capture the numeric portion, you need to do some regex fun 😄:\n\n```python\napp.route(r\"/image/\\d+)\\.jpg>\")\n```\n\nFurther, these should all be acceptable:\n\n```python\n@app.get(r\"/\") # matching on the full pattern\n@app.get(r\"/\") # defining a single matching group\n@app.get(r\"/[a-z]{3}).txt>\") # defining a single named matching group\n@app.get(r\"/[a-z]{3}).(?:txt)>\") # defining a single named matching group, with one or more non-matching groups\n```\n\nAlso, if using a named matching group, it must be the same as the segment label.\n\n```python\n@app.get(r\"/\\d+).jpg>\") # OK\n@app.get(r\"/\\d+).jpg>\") # NOT OK\n```\n\nFor more regular usage methods, please refer to [Regular expression operations](https://docs.python.org/3/library/re.html)\n\n## Generating a URL\n\n.. column::\n\n Sanic provides a method to generate URLs based on the handler method name: `app.url_for()`. This is useful if you want to avoid hardcoding url paths into your app; instead, you can just reference the handler name.\n\n.. column::\n\n ```python\n @app.route('/')\n async def index(request):\n # generate a URL for the endpoint `post_handler`\n url = app.url_for('post_handler', post_id=5)\n\n # Redirect to `/posts/5`\n return redirect(url)\n\n @app.route('/posts/')\n async def post_handler(request, post_id):\n ...\n ```\n\n\n.. column::\n\n You can pass any arbitrary number of keyword arguments. Anything that is _not_ a request parameter will be implemented as a part of the query string.\n\n.. column::\n\n ```python\n assert app.url_for(\n \"post_handler\",\n post_id=5,\n arg_one=\"one\",\n arg_two=\"two\",\n ) == \"/posts/5?arg_one=one&arg_two=two\"\n ```\n\n\n.. column::\n\n Also supported is passing multiple values for a single query key.\n\n.. column::\n\n ```python\n assert app.url_for(\n \"post_handler\",\n post_id=5,\n arg_one=[\"one\", \"two\"],\n ) == \"/posts/5?arg_one=one&arg_one=two\"\n ```\n\n### Special keyword arguments\n\nSee [API Docs]() for more details.\n\n```python\napp.url_for(\"post_handler\", post_id=5, arg_one=\"one\", _anchor=\"anchor\")\n# '/posts/5?arg_one=one#anchor'\n\n# _external requires you to pass an argument _server or set SERVER_NAME in app.config if not url will be same as no _external\napp.url_for(\"post_handler\", post_id=5, arg_one=\"one\", _external=True)\n# '//server/posts/5?arg_one=one'\n\n# when specifying _scheme, _external must be True\napp.url_for(\"post_handler\", post_id=5, arg_one=\"one\", _scheme=\"http\", _external=True)\n# 'http://server/posts/5?arg_one=one'\n\n# you can pass all special arguments at once\napp.url_for(\"post_handler\", post_id=5, arg_one=[\"one\", \"two\"], arg_two=2, _anchor=\"anchor\", _scheme=\"http\", _external=True, _server=\"another_server:8888\")\n# 'http://another_server:8888/posts/5?arg_one=one&arg_one=two&arg_two=2#anchor'\n```\n\n### Customizing a route name\n\n.. column::\n\n A custom route name can be used by passing a `name` argument while registering the route.\n\n.. column::\n\n ```python\n @app.get(\"/get\", name=\"get_handler\")\n def handler(request):\n return text(\"OK\")\n ```\n\n\n.. column::\n\n Now, use this custom name to retrieve the URL\n\n.. column::\n\n ```python\n assert app.url_for(\"get_handler\", foo=\"bar\") == \"/get?foo=bar\"\n ```\n\n## Websockets routes\n\n.. column::\n\n Websocket routing works similar to HTTP methods.\n\n.. column::\n\n ```python\n async def handler(request, ws):\n message = \"Start\"\n while True:\n await ws.send(message)\n message = await ws.recv()\n\n app.add_websocket_route(handler, \"/test\")\n ```\n\n\n.. column::\n\n It also has a convenience decorator.\n\n.. column::\n\n ```python\n @app.websocket(\"/test\")\n async def handler(request, ws):\n message = \"Start\"\n while True:\n await ws.send(message)\n message = await ws.recv()\n ```\n\nRead the [websockets section](../advanced/websockets.md) to learn more about how they work.\n\n## Strict slashes\n\n\n.. column::\n\n Sanic routes can be configured to strictly match on whether or not there is a trailing slash: `/`. This can be configured at a few levels and follows this order of precedence:\n\n 1. Route\n 2. Blueprint\n 3. BlueprintGroup\n 4. Application\n\n.. column::\n\n ```python\n # provide default strict_slashes value for all routes\n app = Sanic(__file__, strict_slashes=True)\n ```\n\n ```python\n # overwrite strict_slashes value for specific route\n @app.get(\"/get\", strict_slashes=False)\n def handler(request):\n return text(\"OK\")\n ```\n\n ```python\n # it also works for blueprints\n bp = Blueprint(__file__, strict_slashes=True)\n\n @bp.get(\"/bp/get\", strict_slashes=False)\n def handler(request):\n return text(\"OK\")\n ```\n\n ```python\n bp1 = Blueprint(name=\"bp1\", url_prefix=\"/bp1\")\n bp2 = Blueprint(\n name=\"bp2\",\n url_prefix=\"/bp2\",\n strict_slashes=False,\n )\n\n # This will enforce strict slashes check on the routes\n # under bp1 but ignore bp2 as that has an explicitly\n # set the strict slashes check to false\n group = Blueprint.group([bp1, bp2], strict_slashes=True)\n ```\n\n## Static files\n\n.. column::\n\n In order to serve static files from Sanic, use `app.static()`.\n\n The order of arguments is important:\n\n 1. Route the files will be served from\n 2. Path to the files on the server\n\n See [API docs](https://sanic.readthedocs.io/en/stable/sanic/api/app.html#sanic.app.Sanic.static) for more details.\n\n.. column::\n\n ```python\n app.static(\"/static/\", \"/path/to/directory/\")\n ```\n\n\n\n.. tip:: \n\n It is generally best practice to end your directory paths with a trailing slash (`/this/is/a/directory/`). This removes ambiguity by being more explicit.\n\n\n\n\n.. column::\n\n You can also serve individual files.\n\n.. column::\n\n ```python\n app.static(\"/\", \"/path/to/index.html\")\n ```\n\n\n.. column::\n\n It is also sometimes helpful to name your endpoint\n\n.. column::\n\n ```python\n app.static(\n \"/user/uploads/\",\n \"/path/to/uploads/\",\n name=\"uploads\",\n )\n ```\n\n\n.. column::\n\n Retrieving the URLs works similar to handlers. But, we can also add the `filename` argument when we need a specific file inside a directory.\n\n.. column::\n\n ```python\n assert app.url_for(\n \"static\",\n name=\"static\",\n filename=\"file.txt\",\n ) == \"/static/file.txt\"\n ```\n ```python\n assert app.url_for(\n \"static\",\n name=\"uploads\",\n filename=\"image.png\",\n ) == \"/user/uploads/image.png\"\n\n ```\n\n\n\n.. tip:: \n\n If you are going to have multiple `static()` routes, then it is *highly* suggested that you manually name them. This will almost certainly alleviate potential hard to discover bugs.\n\n ```python\n app.static(\"/user/uploads/\", \"/path/to/uploads/\", name=\"uploads\")\n app.static(\"/user/profile/\", \"/path/to/profile/\", name=\"profile_pics\")\n ```\n\n\n#### Auto index serving\n\n.. column::\n\n If you have a directory of static files that should be served by an index page, you can provide the filename of the index. Now, when reaching that directory URL, the index page will be served.\n\n.. column::\n\n ```python\n app.static(\"/foo/\", \"/path/to/foo/\", index=\"index.html\")\n ```\n\n*Added in v23.3*\n\n#### File browser\n\n.. column::\n\n When serving a directory from a static handler, Sanic can be configured to show a basic file browser instead using `directory_view=True`.\n\n.. column::\n\n ```python\n app.static(\"/uploads/\", \"/path/to/dir\", directory_view=True)\n ```\n\nYou now have a browsable directory in your web browser:\n\n![image](/assets/images/directory-view.png)\n\n*Added in v23.3*\n\n#### Symlink control\n\n.. new:: New in v25.12\n\n This feature was added in version 25.12\n\n.. column::\n\n By default, Sanic will not follow symlinks that point outside the static root directory for security reasons. You can enable external symlinks separately for files and directories using `follow_external_symlink_files` and `follow_external_symlink_dirs`.\n\n.. column::\n\n ```python\n # Allow file symlinks pointing outside static root\n app.static(\n \"/static\",\n \"/var/www/static\",\n follow_external_symlink_files=True,\n )\n\n # Allow directory symlinks pointing outside static root\n app.static(\n \"/static\",\n \"/var/www/static\",\n follow_external_symlink_dirs=True,\n )\n ```\n\nSymlinks within the static root always work regardless of these settings. Broken symlinks are always hidden from directory listings and return 404.\n\n*Added in v25.12*\n\n## Route context\n\n\n.. column::\n\n When a route is defined, you can add any number of keyword arguments with a `ctx_` prefix. These values will be injected into the route `ctx` object.\n\n.. column::\n\n ```python\n @app.get(\"/1\", ctx_label=\"something\")\n async def handler1(request):\n ...\n\n @app.get(\"/2\", ctx_label=\"something\")\n async def handler2(request):\n ...\n\n @app.get(\"/99\")\n async def handler99(request):\n ...\n\n @app.on_request\n async def do_something(request):\n if request.route.ctx.label == \"something\":\n ...\n ```\n\n*Added in v21.12*\n" }, { "path": "guide/content/en/guide/basics/tasks.md", "content": "---\ntitle: Background tasks\n---\n\n# Background tasks\n\n## Creating Tasks\nIt is often desirable and very convenient to make usage of [tasks](https://docs.python.org/3/library/asyncio-task.html#asyncio.create_task) in async Python. Sanic provides a convenient method to add tasks to the currently **running** loop. It is somewhat similar to `asyncio.create_task`. For adding tasks before the 'App' loop is running, see next section.\n\n```python\nasync def notify_server_started_after_five_seconds():\n await asyncio.sleep(5)\n print('Server successfully started!')\n\napp.add_task(notify_server_started_after_five_seconds())\n```\n\n.. column::\n\n Sanic will attempt to automatically inject the app, passing it as an argument to the task.\n\n.. column::\n\n ```python\n async def auto_inject(app):\n await asyncio.sleep(5)\n print(app.name)\n\n app.add_task(auto_inject)\n ```\n\n\n.. column::\n\n Or you can pass the `app` argument explicitly.\n\n.. column::\n\n ```python\n async def explicit_inject(app):\n await asyncio.sleep(5)\n print(app.name)\n\n app.add_task(explicit_inject(app))\n ```\n\n.. column::\n\n The `add_task` method returns the created `asyncio.Task` object, allowing you to await or check its result later.\n\n *Added in v25.12*\n\n.. column::\n\n ```python\n task = app.add_task(some_coroutine())\n # Later...\n result = await task\n ```\n\n## Adding tasks before `app.run`\n\nIt is possible to add background tasks before the App is run ie. before `app.run`. To add a task before the App is run, it is recommended to not pass the coroutine object (ie. one created by calling the `async` callable), but instead just pass the callable and Sanic will create the coroutine object on **each worker**. Note: the tasks that are added such are run as `before_server_start` jobs and thus run on every worker (and not in the main process). This has certain consequences, please read [this comment](https://github.com/sanic-org/sanic/issues/2139#issuecomment-868993668) on [this issue](https://github.com/sanic-org/sanic/issues/2139) for further details.\n\nTo add work on the main process, consider adding work to [`@app.main_process_start`](./listeners.md). Note: the workers won't start until this work is completed.\n\n.. column::\n\n Example to add a task before `app.run`\n\n.. column::\n\n ```python\n async def slow_work():\n ...\n \n async def even_slower(num):\n ...\n\n app = Sanic(...)\n app.add_task(slow_work) # Note: we are passing the callable and not coroutine object ...\n app.add_task(even_slower(10)) # ... or we can call the function and pass the coroutine.\n app.run(...)\n ```\n\n## Named tasks\n\n.. column::\n\n When creating a task, you can ask Sanic to keep track of it for you by providing a `name`.\n\n.. column::\n\n ```python\n app.add_task(slow_work, name=\"slow_task\")\n ```\n\n\n.. column::\n\n You can now retrieve that task instance from anywhere in your application using `get_task`.\n\n.. column::\n\n ```python\n task = app.get_task(\"slow_task\")\n ```\n\n.. column::\n\n If that task needs to be cancelled, you can do that with `cancel_task`. Make sure that you `await` it.\n\n.. column::\n\n ```python\n await app.cancel_task(\"slow_task\")\n ```\n\n.. column::\n\n All registered tasks can be found in the `app.tasks` property. To prevent cancelled tasks from filling up, you may want to run `app.purge_tasks` that will clear out any completed or cancelled tasks.\n\n.. column::\n\n ```python\n app.purge_tasks()\n ```\n\nThis pattern can be particularly useful with `websockets`:\n\n```python\nasync def receiver(ws):\n while True:\n message = await ws.recv()\n if not message:\n break\n print(f\"Received: {message}\")\n\n@app.websocket(\"/feed\")\nasync def feed(request, ws):\n task_name = f\"receiver:{request.id}\"\n request.app.add_task(receiver(ws), name=task_name)\n try:\n while True:\n await request.app.event(\"my.custom.event\")\n await ws.send(\"A message\")\n finally:\n # When the websocket closes, let's cleanup the task\n await request.app.cancel_task(task_name)\n request.app.purge_tasks()\n```\n\n*Added in v21.12*\n" }, { "path": "guide/content/en/guide/best-practices/blueprints.md", "content": "# Blueprints\n\n## Overview\n\nBlueprints are objects that can be used for sub-routing within an application. Instead of adding routes to the application instance, blueprints define similar methods for adding routes, which are then registered with the application in a flexible and pluggable manner.\n\nBlueprints are especially useful for larger applications, where your application logic can be broken down into several groups or areas of responsibility.\n\n## Creating and registering\n\n.. column::\n\n First, you must create a blueprint. It has a very similar API as the `Sanic()` app instance with many of the same decorators.\n\n.. column::\n\n ```python\n # ./my_blueprint.py\n from sanic.response import json\n from sanic import Blueprint\n\n bp = Blueprint(\"my_blueprint\")\n\n @bp.route(\"/\")\n async def bp_root(request):\n return json({\"my\": \"blueprint\"})\n ```\n\n\n\n.. column::\n\n Next, you register it with the app instance.\n\n.. column::\n\n ```python\n from sanic import Sanic\n from my_blueprint import bp\n\n app = Sanic(__name__)\n app.blueprint(bp)\n ```\n\nBlueprints also have the same `websocket()` decorator and `add_websocket_route` method for implementing websockets.\n\n.. column::\n\n Beginning in v21.12, a Blueprint may be registered before or after adding objects to it. Previously, only objects attached to the Blueprint at the time of registration would be loaded into application instance.\n\n.. column::\n\n ```python\n app.blueprint(bp)\n\n @bp.route(\"/\")\n async def bp_root(request):\n ...\n ```\n\n## Copying\n\n.. column::\n\n Blueprints along with everything that is attached to them can be copied to new instances using the `copy()` method. The only required argument is to pass it a new `name`. However, you could also use this to override any of the values from the old blueprint.\n\n.. column::\n\n ```python\n v1 = Blueprint(\"Version1\", version=1)\n\n @v1.route(\"/something\")\n def something(request):\n pass\n\n v2 = v1.copy(\"Version2\", version=2)\n\n app.blueprint(v1)\n app.blueprint(v2)\n ```\n\n ```\n Available routes:\n /v1/something\n /v2/something\n\n ```\n\n*Added in v21.9*\n\n## Blueprint groups\n\nBlueprints may also be registered as part of a list or tuple, where the registrar will recursively cycle through any sub-sequences of blueprints and register them accordingly. The Blueprint.group method is provided to simplify this process, allowing a ‘mock’ backend directory structure mimicking what’s seen from the front end. Consider this (quite contrived) example:\n\n```text\napi/\n├──content/\n│ ├──authors.py\n│ ├──static.py\n│ └──__init__.py\n├──info.py\n└──__init__.py\napp.py\n```\n\n.. column::\n\n #### First blueprint\n\n.. column::\n\n ```python\n # api/content/authors.py\n from sanic import Blueprint\n\n authors = Blueprint(\"content_authors\", url_prefix=\"/authors\")\n ```\n\n\n.. column::\n\n #### Second blueprint\n\n.. column::\n\n ```python\n # api/content/static.py\n from sanic import Blueprint\n\n static = Blueprint(\"content_static\", url_prefix=\"/static\")\n ```\n\n\n.. column::\n\n #### Blueprint group\n\n.. column::\n\n ```python\n # api/content/__init__.py\n from sanic import Blueprint\n from .static import static\n from .authors import authors\n\n content = Blueprint.group(static, authors, url_prefix=\"/content\")\n ```\n\n\n.. column::\n\n #### Third blueprint\n\n.. column::\n\n ```python\n # api/info.py\n from sanic import Blueprint\n\n info = Blueprint(\"info\", url_prefix=\"/info\")\n ```\n\n\n.. column::\n\n #### Another blueprint group\n\n.. column::\n\n ```python\n # api/__init__.py\n from sanic import Blueprint\n from .content import content\n from .info import info\n\n api = Blueprint.group(content, info, url_prefix=\"/api\")\n ```\n\n\n.. column::\n\n #### Main server\n\n All blueprints are now registered\n\n.. column::\n\n ```python\n # app.py\n from sanic import Sanic\n from .api import api\n\n app = Sanic(__name__)\n app.blueprint(api)\n ```\n\n### Blueprint group prefixes and composability\n\nAs shown in the code above, when you create a group of blueprints you can extend the URL prefix of all the blueprints in the group by passing the `url_prefix` argument to the `Blueprint.group` method. This is useful for creating a mock directory structure for your API.\n\n\nIn addition, there is a `name_prefix` argument that can be used to make blueprints reusable and composable. The is specifically necessary when applying a single blueprint to multiple groups. By doing this, the blueprint will be registered with a unique name for each group, which allows the blueprint to be registered multiple times and have its routes each properly named with a unique identifier.\n\n.. column::\n\n Consider this example. The routes built will be named as follows:\n - `TestApp.group-a_bp1.route1`\n - `TestApp.group-a_bp2.route2`\n - `TestApp.group-b_bp1.route1`\n - `TestApp.group-b_bp2.route2`\n\n.. column::\n\n ```python\n bp1 = Blueprint(\"bp1\", url_prefix=\"/bp1\")\n bp2 = Blueprint(\"bp2\", url_prefix=\"/bp2\")\n\n bp1.add_route(lambda _: ..., \"/\", name=\"route1\")\n bp2.add_route(lambda _: ..., \"/\", name=\"route2\")\n\n group_a = Blueprint.group(\n bp1, bp2, url_prefix=\"/group-a\", name_prefix=\"group-a\"\n )\n group_b = Blueprint.group(\n bp1, bp2, url_prefix=\"/group-b\", name_prefix=\"group-b\"\n )\n\n app = Sanic(\"TestApp\")\n app.blueprint(group_a)\n app.blueprint(group_b)\n ```\n\n*Name prefixing added in v23.6*\n\n\n## Middleware\n\n.. column::\n\n Blueprints can also have middleware that is specifically registered for its endpoints only.\n\n.. column::\n\n ```python\n @bp.middleware\n async def print_on_request(request):\n print(\"I am a spy\")\n\n @bp.middleware(\"request\")\n async def halt_request(request):\n return text(\"I halted the request\")\n\n @bp.middleware(\"response\")\n async def halt_response(request, response):\n return text(\"I halted the response\")\n ```\n\n\n.. column::\n\n Similarly, using blueprint groups, it is possible to apply middleware to an entire group of nested blueprints.\n\n.. column::\n\n ```python\n bp1 = Blueprint(\"bp1\", url_prefix=\"/bp1\")\n bp2 = Blueprint(\"bp2\", url_prefix=\"/bp2\")\n\n @bp1.middleware(\"request\")\n async def bp1_only_middleware(request):\n print(\"applied on Blueprint : bp1 Only\")\n\n @bp1.route(\"/\")\n async def bp1_route(request):\n return text(\"bp1\")\n\n @bp2.route(\"/\")\n async def bp2_route(request, param):\n return text(param)\n\n group = Blueprint.group(bp1, bp2)\n\n @group.middleware(\"request\")\n async def group_middleware(request):\n print(\"common middleware applied for both bp1 and bp2\")\n\n # Register Blueprint group under the app\n app.blueprint(group)\n ```\n\n## Exceptions\n\n.. column::\n\n Just like other [exception handling](./exceptions.md), you can define blueprint specific handlers.\n\n.. column::\n\n ```python\n @bp.exception(NotFound)\n def ignore_404s(request, exception):\n return text(\"Yep, I totally found the page: {}\".format(request.url))\n ```\n\n## Static files\n\n.. column::\n\n Blueprints can also have their own static handlers\n\n.. column::\n\n ```python\n bp = Blueprint(\"bp\", url_prefix=\"/bp\")\n bp.static(\"/web/path\", \"/folder/to/serve\")\n bp.static(\"/web/path\", \"/folder/to/server\", name=\"uploads\")\n ```\n\n\n.. column::\n\n Which can then be retrieved using `url_for()`. See [routing](../basics/routing.md) for more information.\n\n.. column::\n\n ```python\n >>> print(app.url_for(\"static\", name=\"bp.uploads\", filename=\"file.txt\"))\n '/bp/web/path/file.txt'\n ```\n\n## Listeners\n\n.. column::\n\n Blueprints can also implement [listeners](../basics/listeners.md).\n\n.. column::\n\n ```python\n @bp.listener(\"before_server_start\")\n async def before_server_start(app, loop):\n ...\n\n @bp.listener(\"after_server_stop\")\n async def after_server_stop(app, loop):\n ...\n ```\n\n## Versioning\n\nAs discussed in the [versioning section](../advanced/versioning.md), blueprints can be used to implement different versions of a web API.\n\n.. column::\n\n The `version` will be prepended to the routes as `/v1` or `/v2`, etc.\n\n.. column::\n\n ```python\n auth1 = Blueprint(\"auth\", url_prefix=\"/auth\", version=1)\n auth2 = Blueprint(\"auth\", url_prefix=\"/auth\", version=2)\n ```\n\n\n.. column::\n\n When we register our blueprints on the app, the routes `/v1/auth` and `/v2/auth` will now point to the individual blueprints, which allows the creation of sub-sites for each API version.\n\n.. column::\n\n ```python\n from auth_blueprints import auth1, auth2\n\n app = Sanic(__name__)\n app.blueprint(auth1)\n app.blueprint(auth2)\n ```\n\n\n.. column::\n\n It is also possible to group the blueprints under a `BlueprintGroup` entity and version multiple of them together at the\n same time.\n\n.. column::\n\n ```python\n auth = Blueprint(\"auth\", url_prefix=\"/auth\")\n metrics = Blueprint(\"metrics\", url_prefix=\"/metrics\")\n\n group = Blueprint.group(auth, metrics, version=\"v1\")\n\n # This will provide APIs prefixed with the following URL path\n # /v1/auth/ and /v1/metrics\n ```\n\n## Composable\n\nA `Blueprint` may be registered to multiple groups, and each of `BlueprintGroup` itself could be registered and nested further. This creates a limitless possibility `Blueprint` composition.\n\n*Added in v21.6*\n\n.. column::\n\n Take a look at this example and see how the two handlers are actually mounted as five (5) distinct routes.\n\n.. column::\n\n ```python\n app = Sanic(__name__)\n blueprint_1 = Blueprint(\"blueprint_1\", url_prefix=\"/bp1\")\n blueprint_2 = Blueprint(\"blueprint_2\", url_prefix=\"/bp2\")\n group = Blueprint.group(\n blueprint_1,\n blueprint_2,\n version=1,\n version_prefix=\"/api/v\",\n url_prefix=\"/grouped\",\n strict_slashes=True,\n )\n primary = Blueprint.group(group, url_prefix=\"/primary\")\n\n @blueprint_1.route(\"/\")\n def blueprint_1_default_route(request):\n return text(\"BP1_OK\")\n\n @blueprint_2.route(\"/\")\n def blueprint_2_default_route(request):\n return text(\"BP2_OK\")\n\n app.blueprint(group)\n app.blueprint(primary)\n app.blueprint(blueprint_1)\n\n # The mounted paths:\n # /api/v1/grouped/bp1/\n # /api/v1/grouped/bp2/\n # /api/v1/primary/grouped/bp1\n # /api/v1/primary/grouped/bp2\n # /bp1\n\n ```\n\n\n## Generating a URL\n\nWhen generating a url with `url_for()`, the endpoint name will be in the form:\n\n```text\n{blueprint_name}.{handler_name}\n```\n" }, { "path": "guide/content/en/guide/best-practices/decorators.md", "content": "# Decorators\n\nOne of the best ways to create a consistent and DRY web API is to make use of decorators to remove functionality from the handlers, and make it repeatable across your views.\n\n.. column::\n\n Therefore, it is very common to see a Sanic view handler with several decorators on it.\n\n.. column::\n\n ```python\n @app.get(\"/orders\")\n @authorized(\"view_order\")\n @validate_list_params()\n @inject_user()\n async def get_order_details(request, params, user):\n ...\n ```\n\n\n## Example\n\nHere is a starter template to help you create decorators.\n\nIn this example, let’s say you want to check that a user is authorized to access a particular endpoint. You can create a decorator that wraps a handler function, checks a request if the client is authorized to access a resource, and sends the appropriate response.\n```python\nfrom functools import wraps\nfrom sanic.response import json\n\ndef authorized():\n def decorator(f):\n @wraps(f)\n async def decorated_function(request, *args, **kwargs):\n # run some method that checks the request\n # for the client's authorization status\n is_authorized = await check_request_for_authorization_status(request)\n\n if is_authorized:\n # the user is authorized.\n # run the handler method and return the response\n response = await f(request, *args, **kwargs)\n return response\n else:\n # the user is not authorized.\n return json({\"status\": \"not_authorized\"}, 403)\n return decorated_function\n return decorator\n\n@app.route(\"/\")\n@authorized()\nasync def test(request):\n return json({\"status\": \"authorized\"})\n```\n\n## Templates\n\nDecorators are **fundamental** to building applications with Sanic. They increase the portability and maintainablity of your code. \n\nIn paraphrasing the Zen of Python: \"[decorators] are one honking great idea -- let's do more of those!\"\n\nTo make it easier to implement them, here are three examples of copy/pastable code to get you started.\n\n.. column::\n\n Don't forget to add these import statements. Although it is *not* necessary, using `@wraps` helps keep some of the metadata of your function intact. [See docs](https://docs.python.org/3/library/functools.html#functools.wraps). Also, we use the `isawaitable` pattern here to allow the route handlers to by regular or asynchronous functions.\n\n.. column::\n\n ```python\n from inspect import isawaitable\n from functools import wraps\n ```\n\n### With args\n\n.. column::\n\n Often, you will want a decorator that will *always* need arguments. Therefore, when it is implemented you will always be calling it.\n\n ```python\n @app.get(\"/\")\n @foobar(1, 2)\n async def handler(request: Request):\n return text(\"hi\")\n ```\n\n.. column::\n\n ```python\n def foobar(arg1, arg2):\n def decorator(f):\n @wraps(f)\n async def decorated_function(request, *args, **kwargs):\n\n response = f(request, *args, **kwargs)\n if isawaitable(response):\n response = await response\n\n return response\n\n return decorated_function\n\n return decorator\n ```\n\n### Without args\n\n.. column::\n\n Sometimes you want a decorator that will not take arguments. When this is the case, it is a nice convenience not to have to call it\n\n ```python\n @app.get(\"/\")\n @foobar\n async def handler(request: Request):\n return text(\"hi\")\n ```\n\n.. column::\n\n ```python\n def foobar(func):\n def decorator(f):\n @wraps(f)\n async def decorated_function(request, *args, **kwargs):\n\n response = f(request, *args, **kwargs)\n if isawaitable(response):\n response = await response\n\n return response\n\n return decorated_function\n\n return decorator(func)\n ```\n\n### With or Without args\n\n.. column::\n\n If you want a decorator with the ability to be called or not, you can follow this pattern. Using keyword only arguments is not necessary, but might make implementation simpler.\n\n ```python\n @app.get(\"/\")\n @foobar(arg1=1, arg2=2)\n async def handler(request: Request):\n return text(\"hi\")\n ```\n\n ```python\n @app.get(\"/\")\n @foobar\n async def handler(request: Request):\n return text(\"hi\")\n ```\n\n.. column::\n\n ```python\n def foobar(maybe_func=None, *, arg1=None, arg2=None):\n def decorator(f):\n @wraps(f)\n async def decorated_function(request, *args, **kwargs):\n\n response = f(request, *args, **kwargs)\n if isawaitable(response):\n response = await response\n\n return response\n\n return decorated_function\n\n return decorator(maybe_func) if maybe_func else decorator\n ```\n\n" }, { "path": "guide/content/en/guide/best-practices/exceptions.md", "content": "# Exceptions\n\n## Using Sanic exceptions\n\nSometimes you just need to tell Sanic to halt execution of a handler and send back a status code response. You can raise a `SanicException` for this and Sanic will do the rest for you.\n\nYou can pass an optional `status_code` argument. By default, a SanicException will return an internal server error 500 response.\n\n```python\nfrom sanic.exceptions import SanicException\n\n@app.route(\"/youshallnotpass\")\nasync def no_no(request):\n raise SanicException(\"Something went wrong.\", status_code=501)\n```\n\nSanic provides a number of standard exceptions. They each automatically will raise the appropriate HTTP status code in your response. [Check the API reference](https://sanic.readthedocs.io/en/latest/sanic/api_reference.html#module-sanic.exceptions) for more details. \n\n.. column::\n\n The more common exceptions you _should_ implement yourself include:\n\n - `BadRequest` (400)\n - `Unauthorized` (401)\n - `Forbidden` (403)\n - `NotFound` (404)\n - `ServerError` (500)\n\n.. column::\n\n ```python\n from sanic import exceptions\n\n @app.route(\"/login\")\n async def login(request):\n user = await some_login_func(request)\n if not user:\n raise exceptions.NotFound(\n f\"Could not find user with username={request.json.username}\"\n )\n ```\n\n## Exception properties\n\nAll exceptions in Sanic derive from `SanicException`. That class has a few properties on it that assist the developer in consistently reporting their exceptions across an application.\n\n- `message`\n- `status_code`\n- `quiet`\n- `headers`\n- `context`\n- `extra`\n\nAll of these properties can be passed to the exception when it is created, but the first three can also be used as class variables as we will see.\n\n.. column::\n\n ### `message`\n\n The `message` property obviously controls the message that will be displayed as with any other exception in Python. What is particularly useful is that you can set the `message` property on the class definition allowing for easy standardization of language across an application\n\n.. column::\n\n ```python\n class CustomError(SanicException):\n message = \"Something bad happened\"\n\n raise CustomError\n # or\n raise CustomError(\"Override the default message with something else\")\n ```\n\n\n.. column::\n\n ### `status_code`\n\n This property is used to set the response code when the exception is raised. This can particularly be useful when creating custom 400 series exceptions that are usually in response to bad information coming from the client.\n\n.. column::\n\n ```python\n class TeapotError(SanicException):\n status_code = 418\n message = \"Sorry, I cannot brew coffee\"\n\n raise TeapotError\n # or\n raise TeapotError(status_code=400)\n ```\n\n\n.. column::\n\n ### `quiet`\n\n By default, exceptions will be output by Sanic to the `error_logger`. Sometimes this may not be desirable, especially if you are using exceptions to trigger events in exception handlers (see [the following section](./exceptions.md#handling)). You can suppress the log output using `quiet=True`.\n\n.. column::\n\n ```python\n class SilentError(SanicException):\n message = \"Something happened, but not shown in logs\"\n quiet = True\n\n raise SilentError\n # or\n raise InvalidUsage(\"blah blah\", quiet=True)\n ```\n\n\n.. column::\n\n Sometimes while debugging you may want to globally ignore the `quiet=True` property. You can force Sanic to log out all exceptions regardless of this property using `NOISY_EXCEPTIONS`\n\n *Added in v21.12*\n\n.. column::\n\n ```python\n app.config.NOISY_EXCEPTIONS = True\n ```\n\n\n.. column::\n\n ### `headers`\n\n Using `SanicException` as a tool for creating responses is super powerful. This is in part because not only can you control the `status_code`, but you can also control reponse headers directly from the exception.\n\n.. column::\n\n ```python\n class MyException(SanicException):\n headers = {\n \"X-Foo\": \"bar\"\n }\n\n raise MyException\n # or\n raise InvalidUsage(\"blah blah\", headers={\n \"X-Foo\": \"bar\"\n })\n ```\n\n\n.. column::\n\n ### `extra`\n\n See [contextual exceptions](./exceptions.md#contextual-exceptions)\n\n *Added in v21.12*\n\n.. column::\n\n ```python\n raise SanicException(..., extra={\"name\": \"Adam\"})\n ```\n\n\n.. column::\n\n ### `context`\n\n See [contextual exceptions](./exceptions.md#contextual-exceptions)\n\n *Added in v21.12*\n\n.. column::\n\n ```python\n raise SanicException(..., context={\"foo\": \"bar\"})\n ```\n\n\n## Handling\n\nSanic handles exceptions automatically by rendering an error page, so in many cases you don't need to handle them yourself. However, if you would like more control on what to do when an exception is raised, you can implement a handler yourself.\n\nSanic provides a decorator for this, which applies to not only the Sanic standard exceptions, but **any** exception that your application might throw.\n\n.. column::\n\n The easiest method to add a handler is to use `@app.exception()` and pass it one or more exceptions.\n\n.. column::\n\n ```python\n from sanic.exceptions import NotFound\n\n @app.exception(NotFound, SomeCustomException)\n async def ignore_404s(request, exception):\n return text(\"Yep, I totally found the page: {}\".format(request.url))\n ```\n\n\n.. column::\n\n You can also create a catchall handler by catching `Exception`.\n\n.. column::\n\n ```python\n @app.exception(Exception)\n async def catch_anything(request, exception):\n ...\n ```\n\n\n.. column::\n\n You can also use `app.error_handler.add()` to add error handlers.\n\n.. column::\n\n ```python\n async def server_error_handler(request, exception):\n return text(\"Oops, server error\", status=500)\n\n app.error_handler.add(Exception, server_error_handler)\n ```\n\n## Built-in error handling\n\nSanic ships with three formats for exceptions: HTML, JSON, and text. You can see examples of them below in the [Fallback handler](#fallback-handler) section.\n\n.. column::\n\n You can control _per route_ which format to use with the `error_format` keyword argument.\n\n *Added in v21.9*\n\n.. column::\n\n ```python\n @app.request(\"/\", error_format=\"text\")\n async def handler(request):\n ...\n ```\n\n\n## Custom error handling\n\nIn some cases, you might want to add some more error handling functionality to what is provided by default. In that case, you can subclass Sanic's default error handler as such:\n\n```python\nfrom sanic.handlers import ErrorHandler\n\nclass CustomErrorHandler(ErrorHandler):\n def default(self, request: Request, exception: Exception) -> HTTPResponse:\n ''' handles errors that have no error handlers assigned '''\n # You custom error handling logic...\n status_code = getattr(exception, \"status_code\", 500)\n return json({\n \"error\": str(exception),\n \"foo\": \"bar\"\n }, status=status_code)\n\napp.error_handler = CustomErrorHandler()\n```\n\n## Fallback handler\n\nSanic comes with three fallback exception handlers:\n\n1. HTML\n2. Text\n3. JSON\n\nThese handlers present differing levels of detail depending upon whether your application is in [debug mode](../running/development.md) or not.\n\nBy default, Sanic will be in \"auto\" mode, which means that it will using the incoming request and potential matching handler to choose the appropriate response format. For example, when in a browser it should always provide an HTML error page. When using curl, you might see JSON or plain text.\n\n### HTML\n\n```python\napp.config.FALLBACK_ERROR_FORMAT = \"html\"\n```\n\n.. column::\n\n ```python\n app.config.DEBUG = True\n ```\n\n ![Error](/assets/images/error-display-html-debug.png)\n\n.. column::\n\n ```python\n app.config.DEBUG = False\n ```\n\n ![Error](/assets/images/error-display-html-prod.png)\n\n### Text\n\n```python\napp.config.FALLBACK_ERROR_FORMAT = \"text\"\n```\n\n.. column::\n\n ```python\n app.config.DEBUG = True\n ```\n\n ```sh\n curl localhost:8000/exc -i\n HTTP/1.1 500 Internal Server Error\n content-length: 620\n connection: keep-alive\n content-type: text/plain; charset=utf-8\n\n ⚠️ 500 — Internal Server Error\n ==============================\n That time when that thing broke that other thing? That happened.\n\n ServerError: That time when that thing broke that other thing? That happened. while handling path /exc\n Traceback of TestApp (most recent call last):\n\n ServerError: That time when that thing broke that other thing? That happened.\n File /path/to/sanic/app.py, line 979, in handle_request\n response = await response\n\n File /path/to/server.py, line 16, in handler\n do_something(cause_error=True)\n\n File /path/to/something.py, line 9, in do_something\n raise ServerError(\n ```\n\n.. column::\n\n ```python\n app.config.DEBUG = False\n ```\n\n ```sh\n curl localhost:8000/exc -i\n HTTP/1.1 500 Internal Server Error\n content-length: 134\n connection: keep-alive\n content-type: text/plain; charset=utf-8\n\n ⚠️ 500 — Internal Server Error\n ==============================\n That time when that thing broke that other thing? That happened.\n ```\n\n### JSON\n\n```python\napp.config.FALLBACK_ERROR_FORMAT = \"json\"\n```\n\n.. column::\n\n ```python\n app.config.DEBUG = True\n ```\n\n ```sh\n curl localhost:8000/exc -i\n HTTP/1.1 500 Internal Server Error\n content-length: 572\n connection: keep-alive\n content-type: application/jso\n\n {\n \"description\": \"Internal Server Error\",\n \"status\": 500,\n \"message\": \"That time when that thing broke that other thing? That happened.\",\n \"path\": \"/exc\",\n \"args\": {},\n \"exceptions\": [\n {\n \"type\": \"ServerError\",\n \"exception\": \"That time when that thing broke that other thing? That happened.\",\n \"frames\": [\n {\n \"file\": \"/path/to/sanic/app.py\",\n \"line\": 979,\n \"name\": \"handle_request\",\n \"src\": \"response = await response\"\n },\n {\n \"file\": \"/path/to/server.py\",\n \"line\": 16,\n \"name\": \"handler\",\n \"src\": \"do_something(cause_error=True)\"\n },\n {\n \"file\": \"/path/to/something.py\",\n \"line\": 9,\n \"name\": \"do_something\",\n \"src\": \"raise ServerError(\"\n }\n ]\n }\n ]\n }\n ```\n\n.. column::\n\n ```python\n app.config.DEBUG = False\n ```\n\n ```sh\n curl localhost:8000/exc -i\n HTTP/1.1 500 Internal Server Error\n content-length: 129\n connection: keep-alive\n content-type: application/json\n\n {\n \"description\": \"Internal Server Error\",\n \"status\": 500,\n \"message\": \"That time when that thing broke that other thing? That happened.\"\n }\n\n ```\n\n### Auto\n\nSanic also provides an option for guessing which fallback option to use.\n\n```python\napp.config.FALLBACK_ERROR_FORMAT = \"auto\"\n```\n## Contextual Exceptions\n\nDefault exception messages that simplify the ability to consistently raise exceptions throughout your application.\n\n```python\nclass TeapotError(SanicException):\n status_code = 418\n message = \"Sorry, I cannot brew coffee\"\n\nraise TeapotError\n```\n\nBut this lacks two things:\n\n1. A dynamic and predictable message format\n2. The ability to add additional context to an error message (more on this in a moment)\n\n*Added in v21.12*\n\nUsing one of Sanic's exceptions, you have two options to provide additional details at runtime:\n\n```python\nraise TeapotError(extra={\"foo\": \"bar\"}, context={\"foo\": \"bar\"})\n```\n\nWhat's the difference and when should you decide to use each?\n\n- `extra` - The object itself will **never** be sent to a production client. It is meant for internal use only. What could it be used for?\n - Generating (as we will see in a minute) a dynamic error message\n - Providing runtime details to a logger\n - Debug information (when in development mode, it is rendered)\n- `context` - This object is **always** sent to production clients. It is generally meant to be used to send additional details about the context of what happened. What could it be used for?\n - Providing alternative values on a `BadRequest` validation issue\n - Responding with helpful details for your customers to open a support ticket\n - Displaying state information like current logged in user info\n\n### Dynamic and predictable message using `extra`\n\nSanic exceptions can be raised using `extra` keyword arguments to provide additional information to a raised exception instance.\n\n```python\nclass TeapotError(SanicException):\n status_code = 418\n\n @property\n def message(self):\n return f\"Sorry {self.extra['name']}, I cannot make you coffee\"\n\nraise TeapotError(extra={\"name\": \"Adam\"})\n```\n\nThe new feature allows the passing of `extra` meta to the exception instance, which can be particularly useful as in the above example to pass dynamic data into the message text. This `extra` info object **will be suppressed** when in `PRODUCTION` mode, but displayed in `DEVELOPMENT` mode.\n\n.. column::\n\n **DEVELOPMENT**\n\n ![image](~@assets/images/error-extra-debug.png)\n\n.. column::\n\n **PRODUCTION**\n\n ![image](~@assets/images/error-extra-prod.png)\n\n### Additional `context` to an error message\n\nSanic exceptions can also be raised with a `context` argument to pass intended information along to the user about what happened. This is particularly useful when creating microservices or an API intended to pass error messages in JSON format. In this use case, we want to have some context around the exception beyond just a parseable error message to return details to the client.\n\n```python\nraise TeapotError(context={\"foo\": \"bar\"})\n```\n\nThis is information **that we want** to always be passed in the error (when it is available). Here is what it should look like:\n\n.. column::\n\n **PRODUCTION**\n\n ```json\n {\n \"description\": \"I'm a teapot\",\n \"status\": 418,\n \"message\": \"Sorry Adam, I cannot make you coffee\",\n \"context\": {\n \"foo\": \"bar\"\n }\n }\n ```\n\n.. column::\n\n **DEVELOPMENT**\n\n ```json\n {\n \"description\": \"I'm a teapot\",\n \"status\": 418,\n \"message\": \"Sorry Adam, I cannot make you coffee\",\n \"context\": {\n \"foo\": \"bar\"\n },\n \"path\": \"/\",\n \"args\": {},\n \"exceptions\": [\n {\n \"type\": \"TeapotError\",\n \"exception\": \"Sorry Adam, I cannot make you coffee\",\n \"frames\": [\n {\n \"file\": \"handle_request\",\n \"line\": 83,\n \"name\": \"handle_request\",\n \"src\": \"\"\n },\n {\n \"file\": \"/tmp/p.py\",\n \"line\": 17,\n \"name\": \"handler\",\n \"src\": \"raise TeapotError(\"\n }\n ]\n }\n ]\n }\n ```\n\n\n\n## Error reporting\n\nSanic has a [signal](../advanced/signals.md#built-in-signals) that allows you to hook into the exception reporting process. This is useful if you want to send exception information to a third party service like Sentry or Rollbar. This can be conveniently accomplished by attaching an error reporting handler as show below:\n\n```python\n@app.report_exception\nasync def catch_any_exception(app: Sanic, exception: Exception):\nprint(\"Caught exception:\", exception)\n```\n\n.. note::\n\n This handler will be dispatched into a background task and **IS NOT** intended for use to manipulate any response data. It is intended to be used for logging or reporting purposes only, and should not impact the ability of your application to return the error response to the client.\n\n*Added in v23.6*\n\n" }, { "path": "guide/content/en/guide/best-practices/logging.md", "content": "# Logging\n\nSanic allows you to do different types of logging (access log, error log) on the requests based on the [Python logging API](https://docs.python.org/3/howto/logging.html). You should have some basic knowledge on Python logging if you want to create a new configuration.\n\nBut, don't worry, out of the box Sanic ships with some sensible logging defaults. Out of the box it uses an `AutoFormatter` that will format the logs depending upon whether you are in debug mode or not. We will show you how to force this later on.\n\n## Quick Start\n\nLet's start by looking at what logging might look like in local development. For this, we will use the default logging configuration that Sanic provides and make sure to run Sanic in development mode.\n\n.. column::\n\n A simple example using default settings would be like this:\n\n.. column::\n\n ```python\n from sanic import Sanic\n from sanic.log import logger\n from sanic.response import text\n\n app = Sanic('logging_example')\n\n @app.route('/')\n async def test(request):\n logger.info('Here is your log')\n return text('Hello World!')\n ```\n\n.. column::\n\n Because we are specifically trying to look at the development logs, we will make sure to run Sanic in development mode.\n\n.. column::\n\n ```sh\n sanic path.to.server:app --dev\n ``` \n \n\nAfter the server is running, you should see logs like this.\n\n![Sanic Logging Start](/assets/images/logging-debug-start.png)\n\nYou can send a request to server and it will print the log messages.\n\n![Sanic Logging Access](/assets/images/logging-debug-access.png)\n\nSome important points to note:\n\n- The default log level in **production** mode is `INFO`.\n- The default log level in **debug** mode is `DEBUG`.\n- When in **debug** mode, the log messages will not have a timestamp (except on access logs).\n- Sanic will try to colorize the logs if the terminal supports it. If you are running in Docker with docker-compose, you may need to set `tty: true` in your `docker-compose.yml` file to see the colors.\n\n## Sanic's loggers\n\nOut of the box, Sanic ships with five loggers:\n\n| **Logger Name** | **Use Case** |\n|-------------------|-------------------------------|\n| `sanic.root` | Used to log internal messages. |\n| `sanic.error` | Used to log error logs. |\n| `sanic.access` | Used to log access logs. |\n| `sanic.server` | Used to log server logs. |\n| `sanic.websockets`| Used to log websocket logs. |\n\n.. column::\n\n If you want to use these loggers yourself, you can import them from `sanic.log`.\n \n.. column::\n\n ```python\n from sanic.log import logger, error_logger, access_logger, server_logger, websockets_logger\n \n logger.info('This is a root logger message')\n ```\n \n.. warning::\n\n Feel free to use the root logger and the error logger yourself. But, you probably don't want to use the access logger, server logger, or websockets logger directly. These are used internally by Sanic and are configured to log in a specific way. If you want to change the way these loggers log, you should change the logging configuration.\n \n## Default logging configuration\n\nSanic ships with a default logging configuration that is used when you do not provide your own. This configuration is stored in `sanic.log.LOGGING_CONFIG_DEFAULTS`.\n\n```python\n{\n 'version': 1,\n 'disable_existing_loggers': False,\n 'loggers': {\n 'sanic.root': {'level': 'INFO', 'handlers': ['console']},\n 'sanic.error': {\n 'level': 'INFO',\n 'handlers': ['error_console'],\n 'propagate': True,\n 'qualname': 'sanic.error'\n },\n 'sanic.access': {\n 'level': 'INFO',\n 'handlers': ['access_console'],\n 'propagate': True,\n 'qualname': 'sanic.access'\n },\n 'sanic.server': {\n 'level': 'INFO',\n 'handlers': ['console'],\n 'propagate': True,\n 'qualname': 'sanic.server'\n },\n 'sanic.websockets': {\n 'level': 'INFO',\n 'handlers': ['console'],\n 'propagate': True,\n 'qualname': 'sanic.websockets'\n }\n },\n 'handlers': {\n 'console': {\n 'class': 'logging.StreamHandler',\n 'formatter': 'generic',\n 'stream': sys.stdout\n },\n 'error_console': {\n 'class': 'logging.StreamHandler',\n 'formatter': 'generic',\n 'stream': sys.stderr\n },\n 'access_console': {\n 'class': 'logging.StreamHandler',\n 'formatter': 'access',\n 'stream': sys.stdout\n }\n },\n 'formatters': {\n 'generic': {'class': 'sanic.logging.formatter.AutoFormatter'},\n 'access': {'class': 'sanic.logging.formatter.AutoAccessFormatter'}\n }\n}\n```\n\n## Changing Sanic loggers\n\n.. column::\n\n To use your own logging config, simply use `logging.config.dictConfig`, or pass `log_config` when you initialize Sanic app.\n\n.. column::\n\n ```python\n app = Sanic('logging_example', log_config=LOGGING_CONFIG)\n\n if __name__ == \"__main__\":\n app.run(access_log=False)\n ```\n\n.. column::\n\n But, what if you do not want to control the logging completely, just change the formatter for example? Here, we will import the default logging config and modify only the parts that we want to force (for example) to use the `ProdFormatter` all of the time.\n \n.. column::\n\n ```python\n from sanic.log import LOGGING_CONFIG_DEFAULTS\n \n LOGGING_CONFIG_DEFAULTS['formatters']['generic']['class'] = 'sanic.logging.formatter.ProdFormatter'\n LOGGING_CONFIG_DEFAULTS['formatters']['access']['class'] = 'sanic.logging.formatter.ProdAccessFormatter'\n \n app = Sanic('logging_example', log_config=LOGGING_CONFIG_DEFAULTS)\n ```\n\n\n.. tip:: FYI\n\n Logging in Python is a relatively cheap operation. However, if you are serving a high number of requests and performance is a concern, all of that time logging out access logs adds up and becomes quite expensive. \n\n This is a good opportunity to place Sanic behind a proxy (like nginx) and to do your access logging there. You will see a *significant* increase in overall performance by disabling the `access_log`. \n\n For optimal production performance, it is advised to run Sanic with `debug` and `access_log` disabled: `app.run(debug=False, access_log=False)`\n\n\n## Access logger additional parameters\n\nSanic provides additional parameters to the access logger.\n\n| Log Context Parameter | Parameter Value | Datatype |\n|-----------------------|---------------------------------------|----------|\n| `host` | `request.ip` | `str` |\n| `request` | `request.method + \" \" + request.url` | `str` |\n| `status` | `response` | `int` |\n| `byte` | `len(response.body)` | `int` |\n| `duration` | | `float` |\n\n## Legacy logging\n\nMany logging changes were introduced in Sanic 24.3. The main changes were related to logging formats. If you prefer the legacy logging format, you can use the `sanic.logging.formatter.LegacyFormatter` and `sanic.logging.formatter.LegacyAccessFormatter` formatters.\n" }, { "path": "guide/content/en/guide/best-practices/testing.md", "content": "# Testing\n\nSee [sanic-testing](../../plugins/sanic-testing/getting-started.md)\n" }, { "path": "guide/content/en/guide/deployment/caddy.md", "content": "# Caddy Deployment\n\n## Introduction\n\nCaddy is a state-of-the-art web server and proxy that supports up to HTTP/3. Its simplicity lies in its minimalistic configuration and the inbuilt ability to automatically procure TLS certificates for your domains from Let's Encrypt. In this setup, we will configure the Sanic application to serve locally at 127.0.0.1:8001, with Caddy playing the role of the public-facing server for the domain example.com.\n\nYou may install Caddy from your favorite package menager on Windows, Linux and Mac. The package is named `caddy`.\n\n## Proxied Sanic app\n\n```python\nfrom sanic import Sanic\nfrom sanic.response import text\n\napp = Sanic(\"proxied_example\")\n\n@app.get(\"/\")\ndef index(request):\n # This should display external (public) addresses:\n return text(\n f\"{request.remote_addr} connected to {request.url_for('index')}\\n\"\n f\"Forwarded: {request.forwarded}\\n\"\n )\n```\n\nTo run this application, save as `proxied_example.py`, and use the sanic command-line interface as follows:\n\n```bash\nSANIC_PROXIES_COUNT=1 sanic proxied_example --port 8001\n```\n\nSetting the SANIC_PROXIES_COUNT environment variable instructs Sanic to trust the X-Forwarded-* headers sent by Caddy, allowing it to correctly identify the client's IP address and other information.\n\n## Caddy is simple\n\nIf you have no other web servers running, you can simply run Caddy CLI (needs `sudo` on Linux):\n\n```bash\ncaddy reverse-proxy --from example.com --to :8001\n```\n\nThis is a complete server that includes a certificate for your domain, http-to-https redirect, proxy headers, streaming and WebSockets. Your Sanic application should now be available on the domain you specified by HTTP versions 1, 2 and 3. Remember to open up UDP/443 on your firewall to enable H3 communications.\n\nAll done?\n\nSoon enough you'll be needing more than one server, or more control over details, which is where the configuration files come in. The above command is equivalent to this `Caddyfile`, serving as a good starting point for your install:\n\n```\nexample.com {\n reverse_proxy localhost:8001\n}\n```\n\nSome Linux distributions install Caddy such that it reads configuration from `/etc/caddy/Caddyfile`, which `import /etc/caddy/conf.d/*` for each site you are running. If not, you'll need to manually run `caddy run` as a system service, pointing it at the proper config file. Alternatively, use Caddy API mode with `caddy run --resume` for persistent config changes. Note that any Caddyfile loading will replace all prior configuration and thus `caddy-api` is not configurable in this traditional manner.\n\n## Advanced configuration\n\nAt times, you might need to mix static files and handlers at the site root for cleaner URLs. In Sanic, you'd use `app.static(\"/\", \"static\", index=\"index.html\")` to achieve this. However, for improved performance, you can offload serving static files to Caddy:\n\n```\napp.example.com {\n # Look for static files first, proxy to Sanic if not found\n route {\n file_server {\n root /srv/sanicexample/static\n precompress br # brotli your large scripts and styles\n pass_thru\n }\n reverse_proxy unix//tmp/sanic.socket # sanic --unix /tmp/sanic.socket\n }\n}\n```\n\nPlease refer to [Caddy documentation](https://caddyserver.com/docs/) for more options.\n" }, { "path": "guide/content/en/guide/deployment/docker.md", "content": "# Docker Deployment\n\n## Introduction\n\nFor a long time, the environment has always been a difficult problem for deployment. If there are conflicting configurations in your project, you have to spend a lot of time resolving them. Fortunately, virtualization provides us with a good solution. Docker is one of them. If you don't know Docker, you can visit [Docker official website](https://www.docker.com/) to learn more.\n\n## Build Image\n\nLet's start with a simple project. We will use a Sanic project as an example. Assume the project path is `/path/to/SanicDocker`.\n\n.. column::\n\n The directory structure looks like this:\n\n.. column::\n\n ```text\n # /path/to/SanicDocker\n SanicDocker\n ├── requirements.txt\n ├── dockerfile\n └── server.py\n ```\n\n\n.. column::\n\n And the `server.py` code looks like this:\n\n.. column::\n\n ```python\n app = Sanic(\"MySanicApp\")\n\n @app.get('/')\n async def hello(request):\n return text(\"OK!\")\n\n if __name__ == '__main__':\n app.run(host='0.0.0.0', port=8000)\n ```\n\n\n\n.. note:: \n\n Please note that the host cannot be 127.0.0.1 . In docker container, 127.0.0.1 is the default network interface of the container, only the container can communicate with other containers. more information please visit [Docker network](https://docs.docker.com/engine/reference/commandline/network/)\n\n\n\nCode is ready, let's write the `Dockerfile`:\n\n```Dockerfile\n\nFROM sanicframework/sanic:3.8-latest\n\nWORKDIR /sanic\n\nCOPY . .\n\nRUN pip install -r requirements.txt\n\nEXPOSE 8000\n\nCMD [\"python\", \"server.py\"]\n```\n\nRun the following command to build the image:\n\n```shell\ndocker build -t my-sanic-image .\n```\n\n## Start Container\n\n.. column::\n\n After the image built, we can start the container use `my-sanic-image`:\n\n.. column::\n\n ```shell\n docker run --name mysanic -p 8000:8000 -d my-sanic-image\n ```\n\n\n.. column::\n\n Now we can visit `http://localhost:8000` to see the result:\n\n.. column::\n\n ```text\n OK!\n ```\n\n## Use docker-compose\n\nIf your project consist of multiple services, you can use [docker-compose](https://docs.docker.com/compose/) to manage them.\n\nfor example, we will deploy `my-sanic-image` and `nginx`, achieve through nginx access sanic server.\n\n.. column::\n\n First of all, we need prepare nginx configuration file. create a file named `mysanic.conf`:\n\n.. column::\n\n ```nginx\n server {\n listen 80;\n listen [::]:80;\n location / {\n proxy_pass http://mysanic:8000/;\n proxy_set_header Upgrade $http_upgrade;\n proxy_set_header Connection upgrade;\n proxy_set_header Accept-Encoding gzip;\n }\n }\n ```\n\n\n.. column::\n\n Then, we need to prepare `docker-compose.yml` file. The content follows:\n\n.. column::\n\n ```yaml\n version: \"3\"\n\n services:\n mysanic:\n image: my-sanic-image\n ports:\n - \"8000:8000\"\n restart: always\n\n mynginx:\n image: nginx:1.13.6-alpine\n ports:\n - \"80:80\"\n depends_on:\n - mysanic\n volumes:\n - ./mysanic.conf:/etc/nginx/conf.d/mysanic.conf\n restart: always\n\n networks:\n default:\n driver: bridge\n ```\n\n\n.. column::\n\n After that, we can start them:\n\n.. column::\n\n ```shell\n docker-compose up -d\n ```\n\n\n.. column::\n\n Now, we can visit `http://localhost:80` to see the result:\n\n.. column::\n\n ```text\n OK!\n ```\n\n" }, { "path": "guide/content/en/guide/deployment/kubernetes.md", "content": "# Kubernetes\n" }, { "path": "guide/content/en/guide/deployment/nginx.md", "content": "# Nginx Deployment\n\n## Introduction\n\nAlthough Sanic can be run directly on Internet, it may be useful to use a proxy\nserver such as Nginx in front of it. This is particularly useful for running\nmultiple virtual hosts on the same IP, serving NodeJS or other services beside\na single Sanic app, and it also allows for efficient serving of static files.\nTLS and HTTP/2 are also easily implemented on such proxy.\n\nWe are setting the Sanic app to serve only locally at 127.0.0.1:8001, while the\nNginx installation is responsible for providing the service to public Internet\non domain example.com. Static files will be served by Nginx for maximal\nperformance.\n\n## Proxied Sanic app\n\n```python\nfrom sanic import Sanic\nfrom sanic.response import text\n\napp = Sanic(\"proxied_example\")\n\n@app.get(\"/\")\ndef index(request):\n # This should display external (public) addresses:\n return text(\n f\"{request.remote_addr} connected to {request.url_for('index')}\\n\"\n f\"Forwarded: {request.forwarded}\\n\"\n )\n```\n\nSince this is going to be a system service, save your code to\n`/srv/sanicservice/proxied_example.py`.\n\nFor testing, run your app in a terminal using the `sanic` CLI in the folder where you saved the file.\n\n```bash\nSANIC_FORWARDED_SECRET=_hostname sanic proxied_example --port 8001\n```\n\nWe provide Sanic config `FORWARDED_SECRET` to identify which proxy it gets\nthe remote addresses from. Note the `_` in front of the local hostname.\nThis gives basic protection against users spoofing these headers and faking\ntheir IP addresses and more.\n\n## SSL certificates\n\nInstall Certbot and obtain a certicate for all your domains. This will spin up its own webserver on port 80 for a moment to verify you control the given domain names.\n\n```bash\ncertbot -d example.com -d www.example.com\n```\n\n## Nginx configuration\n\nQuite much configuration is required to allow fast transparent proxying, but\nfor the most part these don't need to be modified, so bear with me.\n\n\n.. tip:: Note\n\n Separate upstream section, rather than simply adding the IP after `proxy_pass`\n as in most tutorials, is needed for HTTP keep-alive. We also enable streaming,\n WebSockets and Nginx serving static files.\n\n\nThe following config goes inside the `http` section of `nginx.conf` or if your\nsystem uses multiple config files, `/etc/nginx/sites-available/default` or\nyour own files (be sure to symlink them to `sites-enabled`):\n\n```nginx\n# Files managed by Certbot\nssl_certificate /etc/letsencrypt/live/example.com/fullchain.pem;\nssl_certificate_key /etc/letsencrypt/live/example.com/privkey.pem;\n\n# Sanic service\nupstream example.com {\n keepalive 100;\n server 127.0.0.1:8001;\n #server unix:/tmp//sanic.sock;\n}\n\nserver {\n server_name example.com;\n listen 443 ssl http2 default_server;\n listen [::]:443 ssl http2 default_server;\n # Serve static files if found, otherwise proxy to Sanic\n location / {\n root /srv/sanicexample/static;\n try_files $uri @sanic;\n }\n location @sanic {\n proxy_pass http://$server_name;\n # Allow fast streaming HTTP/1.1 pipes (keep-alive, unbuffered)\n proxy_http_version 1.1;\n proxy_request_buffering off;\n proxy_buffering off;\n proxy_set_header forwarded 'by=\\\"_$hostname\\\";$for_addr;proto=$scheme;host=\\\"$http_host\\\"';\n # Allow websockets and keep-alive (avoid connection: close)\n proxy_set_header connection \"upgrade\";\n proxy_set_header upgrade $http_upgrade;\n }\n}\n\n# Redirect WWW to no-WWW\nserver {\n listen 443 ssl http2;\n listen [::]:443 ssl http2;\n server_name ~^www\\.(.*)$;\n return 308 $scheme://$1$request_uri;\n}\n\n# Redirect all HTTP to HTTPS with no-WWW\nserver {\n listen 80 default_server;\n listen [::]:80 default_server;\n server_name ~^(?:www\\.)?(.*)$;\n return 308 https://$1$request_uri;\n}\n\n# Forwarded for= client IP address formatting\nmap $remote_addr $for_addr {\n ~^[0-9.]+$ \"for=$remote_addr\"; # IPv4 client address\n ~^[0-9A-Fa-f:.]+$ \"for=\\\"[$remote_addr]\\\"\"; # IPv6 bracketed and quoted\n default \"for=unknown\"; # Unix socket\n}\n```\n\nStart or restart Nginx for changes to take effect. E.g.\n\n```bash\nsystemctl restart nginx\n```\n\nYou should be able to connect your app on `https://example.com`. Any 404\nerrors and such will be handled by Sanic's error pages, and whenever a static\nfile is present at a given path, it will be served by Nginx.\n\n## Running as a service\n\nThis part is for Linux distributions based on `systemd`. Create a unit file\n`/etc/systemd/system/sanicexample.service`\n\n```\n[Unit]\nDescription=Sanic Example\n\n[Service]\nDynamicUser=Yes\nWorkingDirectory=/srv/sanicservice\nEnvironment=SANIC_PROXY_SECRET=_hostname\nExecStart=sanic proxied_example --port 8001 --fast\nRestart=always\n\n[Install]\nWantedBy=multi-user.target\n```\n\nThen reload service files, start your service and enable it on boot:\n\n```bash\nsystemctl daemon-reload\nsystemctl start sanicexample\nsystemctl enable sanicexample\n```\n\n\n.. tip:: Note\n\n For brevity we skipped setting up a separate user account and a Python virtual environment or installing your app as a Python module. There are good tutorials on those topics elsewhere that easily apply to Sanic as well. The DynamicUser setting creates a strong sandbox which basically means your application cannot store its data in files, so you may consider setting `User=sanicexample` instead if you need that.\n\n" }, { "path": "guide/content/en/guide/getting-started.md", "content": "# Getting Started\n\nBefore we begin, make sure you are running Python 3.9 or higher. Currently, Sanic is works with Python versions 3.9 – 3.13.\n\n## Install\n\n```sh\npip install sanic\n```\n\n## Hello, world application\n\n.. column::\n\n If you have ever used one of the many decorator based frameworks, this probably looks somewhat familiar to you.\n\n \n\n .. note:: \n\n If you are coming from Flask or another framework, there are a few important things to point out. Remember, Sanic aims for performance, flexibility, and ease of use. These guiding principles have tangible impact on the API and how it works.\n\n.. column::\n\n ```python\n from sanic import Sanic\n from sanic.response import text\n\n app = Sanic(\"MyHelloWorldApp\")\n\n @app.get(\"/\")\n async def hello_world(request):\n return text(\"Hello, world.\")\n ```\n\n### Important to note\n\n- Every request handler can either be sync (`def hello_world`) or async (`async def hello_world`). Unless you have a clear reason for it, always go with `async`.\n- The `request` object is always the first argument of your handler. Other frameworks pass this around in a context variable to be imported. In the `async` world, this would not work so well and it is far easier (not to mention cleaner and more performant) to be explicit about it. \n- You **must** use a response type. MANY other frameworks allow you to have a return value like this: `return \"Hello, world.\"` or this: `return {\"foo\": \"bar\"}`. But, in order to do this implicit calling, somewhere in the chain needs to spend valuable time trying to determine what you meant. So, at the expense of this ease, Sanic has decided to require an explicit call.\n\n### Running\n\n.. column::\n\n Let's save the above file as `server.py`. And launch it.\n\n.. column::\n\n ```sh\n sanic server\n ```\n\n.. note:: \n\n This **another** important distinction. Other frameworks come with a built in development server and explicitly say that it is _only_ intended for development use. The opposite is true with Sanic. \n\n **The packaged server is production ready.**\n\n\n## Sanic Extensions\n\nSanic intentionally aims for a clean and unopinionated feature list. The project does not want to require you to build your application in a certain way, and tries to avoid prescribing specific development patterns. There are a number of third-party plugins that are built and maintained by the community to add additional features that do not otherwise meet the requirements of the core repository.\n\nHowever, in order **to help API developers**, the Sanic organization maintains an official plugin called [Sanic Extensions](../plugins/sanic-ext/getting-started.md) to provide all sorts of goodies, including:\n\n- **OpenAPI** documentation with Redoc and/or Swagger\n- **CORS** protection\n- **Dependency injection** into route handlers\n- Request query arguments and body input **validation**\n- Auto create `HEAD`, `OPTIONS`, and `TRACE` endpoints\n- Predefined, endpoint-specific response serializers\n\nThe preferred method to set it up is to install it along with Sanic, but you can also install the packages on their own.\n\n.. column::\n\n ```sh\n pip install sanic[ext]\n ```\n\n.. column::\n\n ```sh\n pip install sanic sanic-ext\n ```\n\nStarting in v21.12, Sanic will automatically setup Sanic Extensions if it is in the same environment. You will also have access to two additional application properties:\n\n- `app.extend()` - used to configure Sanic Extensions\n- `app.ext` - the `Extend` instance attached to the application\n\nSee [the plugin documentation](../plugins/sanic-ext/getting-started.md) for more information about how to use and work with the plugin\n" }, { "path": "guide/content/en/guide/how-to/README.md", "content": "# How to ...\n" }, { "path": "guide/content/en/guide/how-to/authentication.md", "content": "# Authentication\n\n> How do I control authentication and authorization?\n\nThis is an _extremely_ complicated subject to cram into a few snippets. But, this should provide you with an idea on ways to tackle this problem. This example uses [JWTs](https://jwt.io/), but the concepts should be equally applicable to sessions or some other scheme.\n\n## `server.py`\n\n```python\nfrom sanic import Sanic, text\n\nfrom auth import protected\nfrom login import login\n\napp = Sanic(\"AuthApp\")\napp.config.SECRET = \"KEEP_IT_SECRET_KEEP_IT_SAFE\"\napp.blueprint(login)\n\n@app.get(\"/secret\")\n@protected\nasync def secret(request):\n return text(\"To go fast, you must be fast.\")\n```\n\n## `login.py`\n\n```python\nimport jwt\nfrom sanic import Blueprint, text\n\nlogin = Blueprint(\"login\", url_prefix=\"/login\")\n\n@login.post(\"/\")\nasync def do_login(request):\n token = jwt.encode({}, request.app.config.SECRET)\n return text(token)\n```\n\n\n\n## `auth.py`\n\n```python\nfrom functools import wraps\n\nimport jwt\nfrom sanic import text\n\ndef check_token(request):\n if not request.token:\n return False\n\n try:\n jwt.decode(\n request.token, request.app.config.SECRET, algorithms=[\"HS256\"]\n )\n except jwt.exceptions.InvalidTokenError:\n return False\n else:\n return True\n\ndef protected(wrapped):\n def decorator(f):\n @wraps(f)\n async def decorated_function(request, *args, **kwargs):\n is_authenticated = check_token(request)\n\n if is_authenticated:\n response = await f(request, *args, **kwargs)\n return response\n else:\n return text(\"You are unauthorized.\", 401)\n\n return decorated_function\n\n return decorator(wrapped)\n```\nThis decorator pattern is taken from the [decorators page](../best-practices/decorators.md).\n\n---\n\n```bash\n$ curl localhost:9999/secret -i\nHTTP/1.1 401 Unauthorized\ncontent-length: 21\nconnection: keep-alive\ncontent-type: text/plain; charset=utf-8\n\nYou are unauthorized.\n\n\n$ curl localhost:9999/login -X POST\neyJ0eXAiOiJKV1QiLCJhbGciOiJIUzI1NiJ9.e30.rjxS7ztIGt5tpiRWS8BGLUqjQFca4QOetHcZTi061DE\n\n\n$ curl localhost:9999/secret -i -H \"Authorization: Bearer eyJ0eXAiOiJKV1QiLCJhbGciOiJIUzI1NiJ9.e30.rjxS7ztIGt5tpiRWS8BGLUqjQFca4QOetHcZTi061DE\"\nHTTP/1.1 200 OK\ncontent-length: 29\nconnection: keep-alive\ncontent-type: text/plain; charset=utf-8\n\nTo go fast, you must be fast.\n\n\n$ curl localhost:9999/secret -i -H \"Authorization: Bearer eyJ0eXAiOiJKV1QiLCJhbGciOiJIUzI1NiJ9.e30.BAD\" \nHTTP/1.1 401 Unauthorized\ncontent-length: 21\nconnection: keep-alive\ncontent-type: text/plain; charset=utf-8\n\nYou are unauthorized.\n```\n\nAlso, checkout some resources from the community:\n\n- Awesome Sanic - [Authorization](https://github.com/mekicha/awesome-sanic/blob/master/README.md#authentication) & [Session](https://github.com/mekicha/awesome-sanic/blob/master/README.md#session)\n- [EuroPython 2020 - Overcoming access control in web APIs](https://www.youtube.com/watch?v=Uqgoj43ky6A)\n" }, { "path": "guide/content/en/guide/how-to/autodiscovery.md", "content": "---\ntitle: Autodiscovery\n---\n\n# Autodiscovery of Blueprints, Middleware, and Listeners\n\n> How do I autodiscover the components I am using to build my application?\n\nOne of the first problems someone faces when building an application, is *how* to structure the project. Sanic makes heavy use of decorators to register route handlers, middleware, and listeners. And, after creating blueprints, they need to be mounted to the application.\n\nA possible solution is a single file in which **everything** is imported and applied to the Sanic instance. Another is passing around the Sanic instance as a global variable. Both of these solutions have their drawbacks.\n\nAn alternative is autodiscovery. You point your application at modules (already imported, or strings), and let it wire everything up.\n\n## `server.py`\n\n```python\nfrom sanic import Sanic\nfrom sanic.response import empty\n\nimport blueprints\nfrom utility import autodiscover\n\napp = Sanic(\"auto\", register=True)\nautodiscover(\n app,\n blueprints,\n \"parent.child\",\n \"listeners.something\",\n recursive=True,\n)\n\napp.route(\"/\")(lambda _: empty())\n```\n```bash\n[2021-03-02 21:37:02 +0200] [880451] [INFO] Goin' Fast @ http://127.0.0.1:9999\n[2021-03-02 21:37:02 +0200] [880451] [DEBUG] something\n[2021-03-02 21:37:02 +0200] [880451] [DEBUG] something @ nested\n[2021-03-02 21:37:02 +0200] [880451] [DEBUG] something @ level1\n[2021-03-02 21:37:02 +0200] [880451] [DEBUG] something @ level3\n[2021-03-02 21:37:02 +0200] [880451] [DEBUG] something inside __init__.py\n[2021-03-02 21:37:02 +0200] [880451] [INFO] Starting worker [880451]\n```\n\n## `utility.py`\n\n```python\n\nfrom glob import glob\nfrom importlib import import_module, util\nfrom inspect import getmembers\nfrom pathlib import Path\nfrom types import ModuleType\nfrom typing import Union\n\nfrom sanic.blueprints import Blueprint\n\ndef autodiscover(\n app, *module_names: Union[str, ModuleType], recursive: bool = False\n):\n mod = app.__module__\n blueprints = set()\n _imported = set()\n\n def _find_bps(module):\n nonlocal blueprints\n\n for _, member in getmembers(module):\n if isinstance(member, Blueprint):\n blueprints.add(member)\n\n for module in module_names:\n if isinstance(module, str):\n module = import_module(module, mod)\n _imported.add(module.__file__)\n _find_bps(module)\n\n if recursive:\n base = Path(module.__file__).parent\n for path in glob(f\"{base}/**/*.py\", recursive=True):\n if path not in _imported:\n name = \"module\"\n if \"__init__\" in path:\n *_, name, __ = path.split(\"/\")\n spec = util.spec_from_file_location(name, path)\n specmod = util.module_from_spec(spec)\n _imported.add(path)\n spec.loader.exec_module(specmod)\n _find_bps(specmod)\n\n for bp in blueprints:\n app.blueprint(bp)\n```\n\n## `blueprints/level1.py`\n\n```python\nfrom sanic import Blueprint\nfrom sanic.log import logger\n\nlevel1 = Blueprint(\"level1\")\n\n@level1.after_server_start\ndef print_something(app, loop):\n logger.debug(\"something @ level1\")\n```\n\n## `blueprints/one/two/level3.py`\n\n```python\nfrom sanic import Blueprint\nfrom sanic.log import logger\n\nlevel3 = Blueprint(\"level3\")\n\n@level3.after_server_start\ndef print_something(app, loop):\n logger.debug(\"something @ level3\")\n```\n\n## `listeners/something.py`\n\n```python\nfrom sanic import Sanic\nfrom sanic.log import logger\n\napp = Sanic.get_app(\"auto\")\n\n@app.after_server_start\ndef print_something(app, loop):\n logger.debug(\"something\")\n```\n\n## `parent/child/__init__.py`\n\n```python\nfrom sanic import Blueprint\nfrom sanic.log import logger\n\nbp = Blueprint(\"__init__\")\n\n@bp.after_server_start\ndef print_something(app, loop):\n logger.debug(\"something inside __init__.py\")\n```\n\n## `parent/child/nested.py`\n\n```python\nfrom sanic import Blueprint\nfrom sanic.log import logger\n\nnested = Blueprint(\"nested\")\n\n@nested.after_server_start\ndef print_something(app, loop):\n logger.debug(\"something @ nested\")\n```\n\n---\n\n```text\nhere is the dir tree\ngenerate with 'find . -type d -name \"__pycache__\" -exec rm -rf {} +; tree'\n\n. # run 'sanic sever -d' here\n├── blueprints\n│ ├── __init__.py # you need add this file, just empty\n│ ├── level1.py\n│ └── one\n│ └── two\n│ └── level3.py\n├── listeners\n│ └── something.py\n├── parent\n│ └── child\n│ ├── __init__.py\n│ └── nested.py\n├── server.py\n└── utility.py\n```\n\n```sh\nsource ./.venv/bin/activate # activate the python venv which sanic is installed in\nsanic sever -d # run this in the directory containing server.py\n```\n\n```text\nyou will see \"something ***\" like this:\n\n[2023-07-12 11:23:36 +0000] [113704] [DEBUG] something\n[2023-07-12 11:23:36 +0000] [113704] [DEBUG] something inside __init__.py\n[2023-07-12 11:23:36 +0000] [113704] [DEBUG] something @ level3\n[2023-07-12 11:23:36 +0000] [113704] [DEBUG] something @ level1\n[2023-07-12 11:23:36 +0000] [113704] [DEBUG] something @ nested\n```\n\n" }, { "path": "guide/content/en/guide/how-to/cors.md", "content": "---\ntitle: CORS\n---\n\n# Cross-origin resource sharing (CORS)\n\n> How do I configure my application for CORS?\n\n.. note::\n\n 🏆 The best solution is to use [Sanic Extensions](../../plugins/sanic-ext/http/cors.md). \n \n However, if you would like to build your own version, you could use this limited example as a starting point.\n\n### `server.py`\n\n```python\nfrom sanic import Sanic, text\n\nfrom cors import add_cors_headers\nfrom options import setup_options\n\napp = Sanic(\"app\")\n\n@app.route(\"/\", methods=[\"GET\", \"POST\"])\nasync def do_stuff(request):\n return text(\"...\")\n\n# Add OPTIONS handlers to any route that is missing it\napp.register_listener(setup_options, \"before_server_start\")\n\n# Fill in CORS headers\napp.register_middleware(add_cors_headers, \"response\")\n```\n\n## `cors.py`\n\n```python\nfrom typing import Iterable\n\ndef _add_cors_headers(response, methods: Iterable[str]) -> None:\n allow_methods = list(set(methods))\n if \"OPTIONS\" not in allow_methods:\n allow_methods.append(\"OPTIONS\")\n headers = {\n \"Access-Control-Allow-Methods\": \",\".join(allow_methods),\n \"Access-Control-Allow-Origin\": \"mydomain.com\",\n \"Access-Control-Allow-Credentials\": \"true\",\n \"Access-Control-Allow-Headers\": (\n \"origin, content-type, accept, \"\n \"authorization, x-xsrf-token, x-request-id\"\n ),\n }\n response.headers.extend(headers)\n\ndef add_cors_headers(request, response):\n if request.method != \"OPTIONS\":\n methods = [method for method in request.route.methods]\n _add_cors_headers(response, methods)\n```\n\n## `options.py`\n\n```python\nfrom collections import defaultdict\nfrom typing import Dict, FrozenSet\n\nfrom sanic import Sanic, response\nfrom sanic.router import Route\n\nfrom cors import _add_cors_headers\n\ndef _compile_routes_needing_options(\n routes: Dict[str, Route]\n) -> Dict[str, FrozenSet]:\n needs_options = defaultdict(list)\n # This is 21.12 and later. You will need to change this for older versions.\n for route in routes.values():\n if \"OPTIONS\" not in route.methods:\n needs_options[route.uri].extend(route.methods)\n\n return {\n uri: frozenset(methods) for uri, methods in dict(needs_options).items()\n }\n\ndef _options_wrapper(handler, methods):\n def wrapped_handler(request, *args, **kwargs):\n nonlocal methods\n return handler(request, methods)\n\n return wrapped_handler\n\nasync def options_handler(request, methods) -> response.HTTPResponse:\n resp = response.empty()\n _add_cors_headers(resp, methods)\n return resp\n\ndef setup_options(app: Sanic, _):\n app.router.reset()\n needs_options = _compile_routes_needing_options(app.router.routes_all)\n for uri, methods in needs_options.items():\n app.add_route(\n _options_wrapper(options_handler, methods),\n uri,\n methods=[\"OPTIONS\"],\n )\n app.router.finalize()\n```\n\n---\n\n```\n$ curl localhost:9999/ -i\nHTTP/1.1 200 OK\nAccess-Control-Allow-Methods: OPTIONS,POST,GET\nAccess-Control-Allow-Origin: mydomain.com\nAccess-Control-Allow-Credentials: true\nAccess-Control-Allow-Headers: origin, content-type, accept, authorization, x-xsrf-token, x-request-id\ncontent-length: 3\nconnection: keep-alive\ncontent-type: text/plain; charset=utf-8\n\n...\n\n$ curl localhost:9999/ -i -X OPTIONS \nHTTP/1.1 204 No Content\nAccess-Control-Allow-Methods: GET,POST,OPTIONS\nAccess-Control-Allow-Origin: mydomain.com\nAccess-Control-Allow-Credentials: true\nAccess-Control-Allow-Headers: origin, content-type, accept, authorization, x-xsrf-token, x-request-id\nconnection: keep-alive\n```\nAlso, checkout some resources from the community:\n\n- [Awesome Sanic](https://github.com/mekicha/awesome-sanic/blob/master/README.md#frontend) \n" }, { "path": "guide/content/en/guide/how-to/csrf.md", "content": "csrf\n" }, { "path": "guide/content/en/guide/how-to/db.md", "content": "connecting to data sources\n" }, { "path": "guide/content/en/guide/how-to/decorators.md", "content": "decorators\n" }, { "path": "guide/content/en/guide/how-to/ipv6.md", "content": "" }, { "path": "guide/content/en/guide/how-to/mounting.md", "content": "# Application Mounting\n\n> How do I mount my application at some path above the root?\n\n```python\n# server.py\nfrom sanic import Sanic, text\n\napp = Sanic(\"app\")\napp.config.SERVER_NAME = \"example.com/api\"\n\n@app.route(\"/foo\")\ndef handler(request):\n url = app.url_for(\"handler\", _external=True)\n return text(f\"URL: {url}\")\n```\n\n```yaml\n# docker-compose.yml\nversion: \"3.7\"\nservices:\n app:\n image: nginx:alpine\n ports:\n - 80:80\n volumes:\n - type: bind\n source: ./conf\n target: /etc/nginx/conf.d/default.conf\n```\n\n```nginx\n# conf\nserver {\n listen 80;\n\n # Computed data service\n location /api/ {\n proxy_pass http://:9999/;\n proxy_set_header Host example.com;\n }\n}\n```\n```bash\n$ docker-compose up -d\n$ sanic server.app --port=9999 --host=0.0.0.0\n```\n```bash\n$ curl localhost/api/foo\nURL: http://example.com/api/foo\n```\n" }, { "path": "guide/content/en/guide/how-to/orm.md", "content": "# ORM\n\n> How do I use SQLAlchemy with Sanic ?\n\nAll ORM tools can work with Sanic, but non-async ORM tool have a impact on Sanic performance.\nThere are some orm packages who support\n\nAt present, there are many ORMs that support Python's `async`/`await` keywords. Some possible choices include：\n\n- [Mayim](https://ahopkins.github.io/mayim/)\n- [SQLAlchemy 1.4](https://docs.sqlalchemy.org/en/14/changelog/changelog_14.html)\n- [tortoise-orm](https://github.com/tortoise/tortoise-orm)\n\nIntegration in to your Sanic application is fairly simple:\n\n## Mayim\n\nMayim ships with [an extension for Sanic Extensions](https://ahopkins.github.io/mayim/guide/extensions.html#sanic), which makes it super simple to get started with Sanic. It is certainly possible to run Mayim with Sanic without the extension, but it is recommended because it handles all of the [lifecycle events](https://sanic.dev/en/guide/basics/listeners.html) and [dependency injections](https://sanic.dev/en/plugins/sanic-ext/injection.html).\n\n.. column::\n\n ### Dependencies\n\n First, we need to install the required dependencies. See [Mayim docs](https://ahopkins.github.io/mayim/guide/install.html#postgres) for the installation needed for your DB driver.\n\n.. column::\n\n ```shell\n pip install sanic-ext\n pip install mayim[postgres]\n ```\n\n\n.. column::\n\n ### Define ORM Model\n\n Mayim allows you to use whatever you want for models. Whether it is [dataclasses](https://docs.python.org/3/library/dataclasses.html), [pydantic](https://pydantic-docs.helpmanual.io/), [attrs](https://www.attrs.org/en/stable/), or even just plain `dict` objects. Since it works very nicely [out of the box with Pydantic](https://ahopkins.github.io/mayim/guide/pydantic.html), that is what we will use here.\n\n.. column::\n\n ```python\n # ./models.py\n from pydantic import BaseModel\n\n class City(BaseModel):\n id: int\n name: str\n district: str\n population: int\n\n class Country(BaseModel):\n code: str\n name: str\n continent: str\n region: str\n capital: City\n ```\n\n\n.. column::\n\n ### Define SQL\n\n If you are unfamiliar, Mayim is different from other ORMs in that it is one-way, SQL-first. This means you define your own queries either inline, or in a separate `.sql` file, which is what we will do here.\n\n.. column::\n\n ```sql\n -- ./queries/select_all_countries.sql\n SELECT country.code,\n country.name,\n country.continent,\n country.region,\n (\n SELECT row_to_json(q)\n FROM (\n SELECT city.id,\n city.name,\n city.district,\n city.population\n ) q\n ) capital\n FROM country\n JOIN city ON country.capital = city.id\n ORDER BY country.name ASC\n LIMIT $limit OFFSET $offset;\n ```\n\n\n.. column::\n\n ### Create Sanic App and Async Engine\n\n We need to create the app instance and attach the `SanicMayimExtension` with any executors.\n\n.. column::\n\n ```python\n # ./server.py\n from sanic import Sanic, Request, json\n from sanic_ext import Extend\n from mayim.executor import PostgresExecutor\n from mayim.extensions import SanicMayimExtension\n from models import Country\n\n class CountryExecutor(PostgresExecutor):\n async def select_all_countries(\n self, limit: int = 4, offset: int = 0\n ) -> list[Country]:\n ...\n\n app = Sanic(\"Test\")\n Extend.register(\n SanicMayimExtension(\n executors=[CountryExecutor],\n dsn=\"postgres://...\",\n )\n )\n ```\n\n\n.. column::\n\n ### Register Routes\n\n Because we are using Mayim's extension for Sanic, we have the automatic `CountryExecutor` injection into the route handler. It makes for an easy, type-annotated development experience.\n\n.. column::\n\n ```python\n @app.get(\"/\")\n async def handler(request: Request, executor: CountryExecutor):\n countries = await executor.select_all_countries()\n return json({\"countries\": [country.dict() for country in co\n ```\n\n\n.. column::\n\n ### Send Requests\n\n.. column::\n\n ```sh\n curl 'http://127.0.0.1:8000'\n {\"countries\":[{\"code\":\"AFG\",\"name\":\"Afghanistan\",\"continent\":\"Asia\",\"region\":\"Southern and Central Asia\",\"capital\":{\"id\":1,\"name\":\"Kabul\",\"district\":\"Kabol\",\"population\":1780000}},{\"code\":\"ALB\",\"name\":\"Albania\",\"continent\":\"Europe\",\"region\":\"Southern Europe\",\"capital\":{\"id\":34,\"name\":\"Tirana\",\"district\":\"Tirana\",\"population\":270000}},{\"code\":\"DZA\",\"name\":\"Algeria\",\"continent\":\"Africa\",\"region\":\"Northern Africa\",\"capital\":{\"id\":35,\"name\":\"Alger\",\"district\":\"Alger\",\"population\":2168000}},{\"code\":\"ASM\",\"name\":\"American Samoa\",\"continent\":\"Oceania\",\"region\":\"Polynesia\",\"capital\":{\"id\":54,\"name\":\"Fagatogo\",\"district\":\"Tutuila\",\"population\":2323}}]}\n ```\n\n\n## SQLAlchemy\n\nBecause [SQLAlchemy 1.4](https://docs.sqlalchemy.org/en/14/changelog/changelog_14.html) has added native support for `asyncio`, Sanic can finally work well with SQLAlchemy. Be aware that this functionality is still considered *beta* by the SQLAlchemy project.\n\n\n.. column::\n\n ### Dependencies\n\n First, we need to install the required dependencies. In the past, the dependencies installed were `sqlalchemy` and `pymysql`, but now `sqlalchemy` and `aiomysql` are needed.\n\n.. column::\n\n ```shell\n pip install -U sqlalchemy\n pip install -U aiomysql\n ```\n\n\n.. column::\n\n ### Define ORM Model\n\n ORM model creation remains the same.\n\n.. column::\n\n ```python\n # ./models.py\n from sqlalchemy import INTEGER, Column, ForeignKey, String\n from sqlalchemy.orm import declarative_base, relationship\n\n Base = declarative_base()\n\n class BaseModel(Base):\n __abstract__ = True\n id = Column(INTEGER(), primary_key=True)\n\n class Person(BaseModel):\n __tablename__ = \"person\"\n name = Column(String())\n cars = relationship(\"Car\")\n\n def to_dict(self):\n return {\"name\": self.name, \"cars\": [{\"brand\": car.brand} for car in self.cars]}\n\n class Car(BaseModel):\n __tablename__ = \"car\"\n\n brand = Column(String())\n user_id = Column(ForeignKey(\"person.id\"))\n user = relationship(\"Person\", back_populates=\"cars\")\n ```\n\n\n.. column::\n\n ### Create Sanic App and Async Engine\n\n Here we use mysql as the database, and you can also choose PostgreSQL/SQLite. Pay attention to changing the driver from `aiomysql` to `asyncpg`/`aiosqlite`.\n\n.. column::\n\n ```python\n # ./server.py\n from sanic import Sanic\n from sqlalchemy.ext.asyncio import create_async_engine\n\n app = Sanic(\"my_app\")\n\n bind = create_async_engine(\"mysql+aiomysql://root:root@localhost/test\", echo=True)\n ```\n\n\n.. column::\n\n ### Register Middlewares\n\n The request middleware creates an usable `AsyncSession` object and set it to `request.ctx` and `_base_model_session_ctx`.\n\n Thread-safe variable `_base_model_session_ctx` helps you to use the session object instead of fetching it from `request.ctx`.\n\n.. column::\n\n ```python\n # ./server.py\n from contextvars import ContextVar\n\n from sqlalchemy.ext.asyncio import AsyncSession\n from sqlalchemy.orm import sessionmaker\n\n _sessionmaker = sessionmaker(bind, AsyncSession, expire_on_commit=False)\n\n _base_model_session_ctx = ContextVar(\"session\")\n\n @app.middleware(\"request\")\n async def inject_session(request):\n request.ctx.session = _sessionmaker()\n request.ctx.session_ctx_token = _base_model_session_ctx.set(request.ctx.session)\n\n @app.middleware(\"response\")\n async def close_session(request, response):\n if hasattr(request.ctx, \"session_ctx_token\"):\n _base_model_session_ctx.reset(request.ctx.session_ctx_token)\n await request.ctx.session.close()\n ```\n\n\n.. column::\n\n ### Register Routes\n\n According to sqlalchemy official docs, `session.query` will be legacy in 2.0, and the 2.0 way to query an ORM object is using `select`.\n\n.. column::\n\n ```python\n # ./server.py\n from sqlalchemy import select\n from sqlalchemy.orm import selectinload\n from sanic.response import json\n\n from models import Car, Person\n\n @app.post(\"/user\")\n async def create_user(request):\n session = request.ctx.session\n async with session.begin():\n car = Car(brand=\"Tesla\")\n person = Person(name=\"foo\", cars=[car])\n session.add_all([person])\n return json(person.to_dict())\n\n @app.get(\"/user/\")\n async def get_user(request, pk):\n session = request.ctx.session\n async with session.begin():\n stmt = select(Person).where(Person.id == pk).options(selectinload(Person.cars))\n result = await session.execute(stmt)\n person = result.scalar()\n\n if not person:\n return json({})\n\n return json(person.to_dict())\n ```\n\n\n.. column::\n\n ### Send Requests\n\n.. column::\n\n ```sh\n curl --location --request POST 'http://127.0.0.1:8000/user'\n {\"name\":\"foo\",\"cars\":[{\"brand\":\"Tesla\"}]}\n ```\n\n ```sh\n curl --location --request GET 'http://127.0.0.1:8000/user/1'\n {\"name\":\"foo\",\"cars\":[{\"brand\":\"Tesla\"}]}\n ```\n\n\n## Tortoise-ORM\n\n.. column::\n\n ### Dependencies\n\n tortoise-orm's dependency is very simple, you just need install tortoise-orm.\n\n.. column::\n\n ```shell\n pip install -U tortoise-orm\n ```\n\n\n.. column::\n\n ### Define ORM Model\n\n If you are familiar with Django, you should find this part very familiar.\n\n.. column::\n\n ```python\n # ./models.py\n from tortoise import Model, fields\n\n class Users(Model):\n id = fields.IntField(pk=True)\n name = fields.CharField(50)\n\n def __str__(self):\n return f\"I am {self.name}\"\n ```\n\n\n\n.. column::\n\n ### Create Sanic App and Async Engine\n\n Tortoise-orm provides a set of registration interface, which is convenient for users, and you can use it to create database connection easily.\n\n.. column::\n\n ```python\n # ./main.py\n\n from models import Users\n from tortoise.contrib.sanic import register_tortoise\n\n app = Sanic(__name__)\n\n register_tortoise(\n app, db_url=\"mysql://root:root@localhost/test\", modules={\"models\": [\"models\"]}, generate_schemas=True\n )\n\n ```\n\n\n.. column::\n\n ### Register Routes\n\n.. column::\n\n ```python\n # ./main.py\n\n from models import Users\n from sanic import Sanic, response\n\n @app.route(\"/user\")\n async def list_all(request):\n users = await Users.all()\n return response.json({\"users\": [str(user) for user in users]})\n\n @app.route(\"/user/\")\n async def get_user(request, pk):\n user = await Users.query(pk=pk)\n return response.json({\"user\": str(user)})\n\n if __name__ == \"__main__\":\n app.run(port=5000)\n ```\n\n\n.. column::\n\n ### Send Requests\n\n.. column::\n\n ```sh\n curl --location --request POST 'http://127.0.0.1:8000/user'\n {\"users\":[\"I am foo\", \"I am bar\"]}\n ```\n\n ```sh\n curl --location --request GET 'http://127.0.0.1:8000/user/1'\n {\"user\": \"I am foo\"}\n ```\n\n" }, { "path": "guide/content/en/guide/how-to/request-id-logging.md", "content": "" }, { "path": "guide/content/en/guide/how-to/serialization.md", "content": "# Serialization\n" }, { "path": "guide/content/en/guide/how-to/server-sent-events.md", "content": "sse\n" }, { "path": "guide/content/en/guide/how-to/static-redirects.md", "content": "# \"Static\" Redirects\n\n> How do I configure static redirects?\n\n## `app.py`\n\n```python\n### SETUP ###\nimport typing\nimport sanic, sanic.response\n\n# Create the Sanic app\napp = sanic.Sanic(__name__)\n\n# This dictionary represents your \"static\"\n# redirects. For example, these values\n# could be pulled from a configuration file.\nREDIRECTS = {\n '/':'/hello_world', # Redirect '/' to '/hello_world'\n '/hello_world':'/hello_world.html' # Redirect '/hello_world' to 'hello_world.html'\n}\n\n# This function will return another function\n# that will return the configured value\n# regardless of the arguments passed to it.\ndef get_static_function(value:typing.Any) -> typing.Callable[..., typing.Any]:\n return lambda *_, **__: value\n\n### ROUTING ###\n# Iterate through the redirects\nfor src, dest in REDIRECTS.items(): \n # Create the redirect response object \n response:sanic.HTTPResponse = sanic.response.redirect(dest)\n\n # Create the handler function. Typically,\n # only a sanic.Request object is passed\n # to the function. This object will be \n # ignored.\n handler = get_static_function(response)\n\n # Route the src path to the handler\n app.route(src)(handler)\n\n# Route some file and client resources\napp.static('/files/', 'files')\napp.static('/', 'client')\n\n### RUN ###\nif __name__ == '__main__':\n app.run(\n '127.0.0.1',\n 10000\n )\n```\n\n## `client/hello_world.html`\n\n```html\n\n\n\n \n \n \n Hello World\n\n\n\n
\n Hello world!\n
\n\n\n```\n\n## `client/hello_world.css`\n\n```css\n#hello_world {\n width: 1000px;\n margin-left: auto;\n margin-right: auto;\n margin-top: 100px;\n\n padding: 100px;\n color: aqua;\n text-align: center;\n font-size: 100px;\n font-family: monospace;\n\n background-color: rgba(0, 0, 0, 0.75);\n\n border-radius: 10px;\n box-shadow: 0 4px 8px 0 rgba(0, 0, 0, 0.75);\n}\n\nbody {\n background-image: url(\"/files/grottoes.jpg\");\n background-repeat: no-repeat;\n background-size: cover;\n}\n```\n\n## `files/grottoes.jpg`\n\n![lake](/assets/images/grottoes.jpg)\n\n---\n\nAlso, checkout some resources from the community:\n\n- [Static Routing Example](https://github.com/Perzan/sanic-static-routing-example)\n" }, { "path": "guide/content/en/guide/how-to/table-of-contents.md", "content": "---\ntitle: Table of Contents\n---\n\n# Table of Contents\n\nWe have compiled fully working examples to answer common questions and user cases. For the most part, the examples are as minimal as possible, but should be complete and runnable solutions.\n\n| Page | How do I ... |\n|:-----|:------------|\n| [Application mounting](./mounting.md) | ... mount my application at some path above the root? |\n| [Authentication](./authentication.md) | ... control authentication and authorization? |\n| [Autodiscovery](./autodiscovery.md) | ... autodiscover the components I am using to build my application? |\n| [CORS](./cors.md) | ... configure my application for CORS? |\n| [ORM](./orm) | ... use an ORM with Sanic? |\n| [\"Static\" Redirects](./static-redirects.md) | ... configure static redirects |\n| [TLS/SSL/HTTPS](./tls.md) | ... run Sanic via HTTPS?
... redirect HTTP to HTTPS? |\n" }, { "path": "guide/content/en/guide/how-to/task-queue.md", "content": "task queue\n" }, { "path": "guide/content/en/guide/how-to/tls.md", "content": "---\ntitle: TLS/SSL/HTTPS\n---\n\n# TLS/SSL/HTTPS\n\n> How do I run Sanic via HTTPS? \n\nIf you do not have TLS certificates yet, [see the end of this page](./tls.md#get-certificates-for-your-domain-names).\n\n## Single domain and single certificate\n\n.. column::\n\n Let Sanic automatically load your certificate files, which need to be named `fullchain.pem` and `privkey.pem` in the given folder:\n\n.. column::\n\n ```sh\n sudo sanic myserver:app -H :: -p 443 \\\n --tls /etc/letsencrypt/live/example.com/\n ```\n ```python\n app.run(\"::\", 443, ssl=\"/etc/letsencrypt/live/example.com/\")\n ```\n\n\n.. column::\n\n Or, you can pass cert and key filenames separately as a dictionary:\n\n Additionally, `password` may be added if the key is encrypted, all fields except for the password are passed to `request.conn_info.cert`.\n\n.. column::\n\n ```python\n ssl = {\n \"cert\": \"/path/to/fullchain.pem\",\n \"key\": \"/path/to/privkey.pem\",\n \"password\": \"for encrypted privkey file\", # Optional\n }\n app.run(host=\"0.0.0.0\", port=8443, ssl=ssl)\n ```\n\n\n.. column::\n\n Alternatively, [`ssl.SSLContext`](https://docs.python.org/3/library/ssl.html) may be passed, if you need full control over details such as which crypto algorithms are permitted. By default Sanic only allows secure algorithms, which may restrict access from very old devices.\n\n.. column::\n\n ```python\n import ssl\n\n context = ssl.create_default_context(ssl.Purpose.CLIENT_AUTH)\n context.load_cert_chain(\"certs/fullchain.pem\", \"certs/privkey.pem\")\n\n app.run(host=\"0.0.0.0\", port=8443, ssl=context)\n ```\n\n\n## Multiple domains with separate certificates\n\n.. column::\n\n A list of multiple certificates may be provided, in which case Sanic chooses the one matching the hostname the user is connecting to. This occurs so early in the TLS handshake that Sanic has not sent any packets to the client yet.\n\n If the client sends no SNI (Server Name Indication), the first certificate on the list will be used even though on the client browser it will likely fail with a TLS error due to name mismatch. To prevent this fallback and to cause immediate disconnection of clients without a known hostname, add `None` as the first entry on the list. `--tls-strict-host` is the equivalent CLI option.\n\n.. column::\n\n ```python\n ssl = [\"certs/example.com/\", \"certs/bigcorp.test/\"]\n app.run(host=\"0.0.0.0\", port=8443, ssl=ssl)\n ```\n ```sh\n sanic myserver:app\n --tls certs/example.com/\n --tls certs/bigcorp.test/\n --tls-strict-host\n ```\n\n.. tip:: \n\n You may also use `None` in front of a single certificate if you do not wish to reveal your certificate, true hostname or site content to anyone connecting to the IP address instead of the proper DNS name.\n\n.. column::\n\n Dictionaries can be used on the list. This allows also specifying which domains a certificate matches to, although the names present on the certificate itself cannot be controlled from here. If names are not specified, the names from the certificate itself are used.\n\n To only allow connections to the main domain **example.com** and only to subdomains of **bigcorp.test**:\n\n.. column::\n\n ```python\n ssl = [\n None, # No fallback if names do not match!\n {\n \"cert\": \"certs/example.com/fullchain.pem\",\n \"key\": \"certs/example.com/privkey.pem\",\n \"names\": [\"example.com\", \"*.bigcorp.test\"],\n }\n ]\n app.run(host=\"0.0.0.0\", port=8443, ssl=ssl)\n ```\n\n## Accessing TLS information in handlers via `request.conn_info` fields\n\n* `.ssl` - is the connection secure (bool)\n* `.cert` - certificate info and dict fields of the currently active cert (dict)\n* `.server_name` - the SNI sent by the client (str, may be empty)\n\nDo note that all `conn_info` fields are per connection, where there may be many requests over time. If a proxy is used in front of your server, these requests on the same pipe may even come from different users.\n\n## Redirect HTTP to HTTPS, with certificate requests still over HTTP\n\nIn addition to your normal server(s) running HTTPS, run another server for redirection, `http_redir.py`:\n\n```python\nfrom sanic import Sanic, exceptions, response\n\napp = Sanic(\"http_redir\")\n\n# Serve ACME/certbot files without HTTPS, for certificate renewals\napp.static(\"/.well-known\", \"/var/www/.well-known\", resource_type=\"dir\")\n\n@app.exception(exceptions.NotFound, exceptions.MethodNotSupported)\ndef redirect_everything_else(request, exception):\n server, path = request.server_name, request.path\n if server and path.startswith(\"/\"):\n return response.redirect(f\"https://{server}{path}\", status=308)\n return response.text(\"Bad Request. Please use HTTPS!\", status=400)\n```\n\nIt is best to setup this as a systemd unit separate of your HTTPS servers. You may need to run HTTP while initially requesting your certificates, while you cannot run the HTTPS server yet. Start for IPv4 and IPv6:\n\n```\nsanic http_redir:app -H 0.0.0.0 -p 80\nsanic http_redir:app -H :: -p 80\n```\n\nAlternatively, it is possible to run the HTTP redirect application from the main application:\n\n```python\n# app == Your main application\n# redirect == Your http_redir application\n@app.before_server_start\nasync def start(app, _):\n app.ctx.redirect = await redirect.create_server(\n port=80, return_asyncio_server=True\n )\n app.add_task(runner(redirect, app.ctx.redirect))\n\n@app.before_server_stop\nasync def stop(app, _):\n await app.ctx.redirect.close()\n\nasync def runner(app, app_server):\n app.state.is_running = True\n try:\n app.signalize()\n app.finalize()\n app.state.is_started = True\n await app_server.serve_forever()\n finally:\n app.state.is_running = False\n app.state.is_stopping = True\n```\n\n## Get certificates for your domain names\n\nYou can get free certificates from [Let's Encrypt](https://letsencrypt.org/). Install [certbot](https://certbot.eff.org/) via your package manager, and request a certificate:\n\n```sh\nsudo certbot certonly --key-type ecdsa --preferred-chain \"ISRG Root X1\" -d example.com -d www.example.com\n```\n\nMultiple domain names may be added by further `-d` arguments, all stored into a single certificate which gets saved to `/etc/letsencrypt/live/example.com/` as per **the first domain** that you list here.\n\nThe key type and preferred chain options are necessary for getting a minimal size certificate file, essential for making your server run as *fast* as possible. The chain will still contain one RSA certificate until when Let's Encrypt gets their new EC chain trusted in all major browsers.\n" }, { "path": "guide/content/en/guide/how-to/validation.md", "content": "validation\n" }, { "path": "guide/content/en/guide/how-to/websocket-feed.md", "content": "websocket feed\n" }, { "path": "guide/content/en/guide/introduction.md", "content": "# Introduction\n\nSanic is a Python 3.10+ web server and web framework that's written to go fast. It allows the usage of the async/await syntax added in Python 3.5, which makes your code non-blocking and speedy.\n\n.. attrs::\n :class: introduction-table\n\n | | |\n |--|--|\n | Build | [![Tests](https://github.com/sanic-org/sanic/actions/workflows/tests.yml/badge.svg?branch=main)](https://github.com/sanic-org/sanic/actions/workflows/tests.yml) |\n | Docs | [![User Guide](https://img.shields.io/badge/user%20guide-sanic-ff0068)](https://sanicframework.org/) [![Documentation](https://readthedocs.org/projects/sanic/badge/?version=latest)](http://sanic.readthedocs.io/en/latest/?badge=latest) |\n | Package | [![PyPI](https://img.shields.io/pypi/v/sanic.svg)](https://pypi.python.org/pypi/sanic/) [![PyPI version](https://img.shields.io/pypi/pyversions/sanic.svg)](https://pypi.python.org/pypi/sanic/) [![Wheel](https://img.shields.io/pypi/wheel/sanic.svg)](https://pypi.python.org/pypi/sanic) [![Supported implementations](https://img.shields.io/pypi/implementation/sanic.svg)](https://pypi.python.org/pypi/sanic) [![Code style black](https://img.shields.io/badge/code%20style-black-000000.svg)](https://github.com/ambv/black) |\n | Support | [![Forums](https://img.shields.io/badge/forums-community-ff0068.svg)](https://community.sanicframework.org/) [![Discord](https://img.shields.io/discord/812221182594121728?logo=discord)](https://discord.gg/FARQzAEMAA) [![Awesome](https://cdn.rawgit.com/sindresorhus/awesome/d7305f38d29fed78fa85652e3a63e154dd8e8829/media/badge.svg)](https://github.com/mekicha/awesome-sanic) |\n | Stats | [![Monthly Downloads](https://img.shields.io/pypi/dm/sanic.svg)](https://pepy.tech/project/sanic) [![Weekly Downloads](https://img.shields.io/pypi/dw/sanic.svg)](https://pepy.tech/project/sanic) [![Conda downloads](https://img.shields.io/conda/dn/conda-forge/sanic.svg)](https://anaconda.org/conda-forge/sanic) |\n\n\n\n## What is it?\n\nFirst things first, before you jump in the water, you should know that Sanic is different than other frameworks.\n\nRight there in that first sentence there is a huge mistake because Sanic is _both_ a **framework** and a **web server**. In the deployment section we will talk a little bit more about this. \n\nBut, remember, out of the box Sanic comes with everything you need to write, deploy, and scale a production grade web application. 🚀\n\n## Goal\n\n> To provide a simple way to get up and running a highly performant HTTP server that is easy to build, to expand, and ultimately to scale.\n## Features\n\n.. column::\n\n ### Core\n\n - Built in, **_fast_** web server\n - Production ready\n - Highly scalable\n - ASGI compliant\n - Simple and intuitive API design\n - By the community, for the community\n\n.. column::\n\n ### Sanic Extensions [[learn more](../plugins/sanic-ext/getting-started.md)]\n\n - CORS protection\n - Template rendering with Jinja\n - Dependency injection into route handlers\n - OpenAPI documentation with Redoc and/or Swagger\n - Predefined, endpoint-specific response serializers\n - Request query arguments and body input validation\n - Auto create `HEAD`, `OPTIONS`, and `TRACE` endpoints\n\n## Sponsor\n\nCheck out [open collective](https://opencollective.com/sanic-org) to learn more about helping to fund Sanic.\n\n\n## Join the Community\n\nThe main channel for discussion is at the [community forums](https://community.sanicframework.org/). There also is a [Discord Server](https://discord.gg/FARQzAEMAA) for live discussion and chat.\n\nThe Stackoverflow `[sanic]` tag is [actively monitored](https://stackoverflow.com/questions/tagged/sanic) by project maintainers.\n\n## Contribution\n\nWe are always happy to have new contributions. We have [marked issues good for anyone looking to get started](https://github.com/sanic-org/sanic/issues?q=is%3Aopen+is%3Aissue+label%3Abeginner), and welcome [questions/answers/discussion on the forums](https://community.sanicframework.org/). Please take a look at our [Contribution guidelines](https://github.com/sanic-org/sanic/blob/master/CONTRIBUTING.rst).\n" }, { "path": "guide/content/en/guide/running/app-loader.md", "content": "---\ntitle: Dynamic Applications\n---\n\n# Dynamic Applications\n\nRunning Sanic has been optimized to work with the CLI. If you have not read it yet, you should read [Running Sanic](./running.md#sanic-server) to become familiar with the options. \n\n.. column::\n\n This includes running it as a global scope object...\n\n.. column::\n\n ```sh\n sanic path.to.server:app\n ```\n ```python\n # server.py\n app = Sanic(\"TestApp\")\n\n @app.get(\"/\")\n async def handler(request: Request):\n return json({\"foo\": \"bar\"})\n ```\n\n\n\n.. column::\n\n ...or, a factory function that creates the `Sanic` application object.\n\n.. column::\n\n ```sh\n sanic path.to.server:create_app --factory\n ```\n ```python\n # server.py\n def create_app():\n app = Sanic(\"TestApp\")\n\n @app.get(\"/\")\n async def handler(request: Request):\n return json({\"foo\": \"bar\"})\n\n return app\n ```\n\n\n**Sometimes, this is not enough ... 🤔**\n\nIntroduced in [v22.9](../../release-notes/2022/v22.9.md), Sanic has an `AppLoader` object that is responsible for creating an application in the various [worker processes](./manager.md#how-sanic-server-starts-processes). You can take advantage of this if you need to create a more dynamic startup experience for your application.\n\n.. column::\n\n An `AppLoader` can be passed a callable that returns a `Sanic` instance. That `AppLoader` could be used with the low-level application running API.\n\n.. column::\n\n ```python\n import sys\n from functools import partial\n\n from sanic import Request, Sanic, json\n from sanic.worker.loader import AppLoader\n\n def attach_endpoints(app: Sanic):\n @app.get(\"/\")\n async def handler(request: Request):\n return json({\"app_name\": request.app.name})\n\n def create_app(app_name: str) -> Sanic:\n app = Sanic(app_name)\n attach_endpoints(app)\n return app\n\n if __name__ == \"__main__\":\n app_name = sys.argv[-1]\n loader = AppLoader(factory=partial(create_app, app_name))\n app = loader.load()\n app.prepare(port=9999, dev=True)\n Sanic.serve(primary=app, app_loader=loader)\n ```\n ```sh\n python path/to/server.py MyTestAppName\n ```\n\nIn the above example, the `AppLoader` is created with a `factory` that can be used to create copies of the same application across processes. When doing this, you should explicitly use the `Sanic.serve` pattern shown above so that the `AppLoader` that you create is not replaced.\n" }, { "path": "guide/content/en/guide/running/configuration.md", "content": "# Configuration\n\n## Basics\n\n\n.. column::\n\n Sanic holds the configuration in the config attribute of the application object. The configuration object is merely an object that can be modified either using dot-notation or like a dictionary.\n\n.. column::\n\n ```python\n app = Sanic(\"myapp\")\n app.config.DB_NAME = \"appdb\"\n app.config[\"DB_USER\"] = \"appuser\"\n ```\n\n\n.. column::\n\n You can also use the `update()` method like on regular dictionaries.\n\n.. column::\n\n ```python\n db_settings = {\n 'DB_HOST': 'localhost',\n 'DB_NAME': 'appdb',\n 'DB_USER': 'appuser'\n }\n app.config.update(db_settings)\n ```\n\n\n\n.. note:: \n\n It is standard practice in Sanic to name your config values in **uppercase letters**. Indeed, you may experience weird behaviors if you start mixing uppercase and lowercase names.\n\n\n\n## Loading\n\n### Environment variables\n\n.. column::\n\n Any environment variables defined with the `SANIC_` prefix will be applied to the Sanic config. For example, setting `SANIC_REQUEST_TIMEOUT` will be loaded by the application automatically and fed into the `REQUEST_TIMEOUT` config variable.\n\n.. column::\n\n ```bash\n $ export SANIC_REQUEST_TIMEOUT=10\n ```\n ```python\n >>> print(app.config.REQUEST_TIMEOUT)\n 10\n ```\n\n\n.. column::\n\n You can change the prefix that Sanic is expecting at startup.\n\n.. column::\n\n ```bash\n $ export MYAPP_REQUEST_TIMEOUT=10\n ```\n ```python\n >>> app = Sanic(__name__, env_prefix='MYAPP_')\n >>> print(app.config.REQUEST_TIMEOUT)\n 10\n ```\n\n\n.. column::\n\n You can also disable environment variable loading completely.\n\n.. column::\n\n ```python\n app = Sanic(__name__, load_env=False)\n ```\n\n### Using Sanic.update_config\n\nThe `Sanic` instance has a _very_ versatile method for loading config: `app.update_config`. You can feed it a path to a file, a dictionary, a class, or just about any other sort of object.\n\n#### From a file\n\n.. column::\n\n Let's say you have `my_config.py` file that looks like this.\n\n.. column::\n\n ```python\n # my_config.py\n A = 1\n B = 2\n ```\n\n\n.. column::\n\n You can load this as config values by passing its path to `app.update_config`.\n\n.. column::\n\n ```python\n >>> app.update_config(\"/path/to/my_config.py\")\n >>> print(app.config.A)\n 1\n ```\n\n\n.. column::\n\n This path also accepts bash style environment variables.\n\n.. column::\n\n ```bash\n $ export my_path=\"/path/to\"\n ```\n ```python\n app.update_config(\"${my_path}/my_config.py\")\n ```\n\n\n\n.. note:: \n \n Just remember that you have to provide environment variables in the format `${environment_variable}` and that `$environment_variable` is not expanded (is treated as \"plain\" text).\n\n\n\n#### From a dict\n\n.. column::\n\n The `app.update_config` method also works on plain dictionaries.\n\n.. column::\n\n ```python\n app.update_config({\"A\": 1, \"B\": 2})\n ```\n\n#### From a class or object\n\n.. column::\n\n You can define your own config class, and pass it to `app.update_config`\n\n.. column::\n\n ```python\n class MyConfig:\n A = 1\n B = 2\n\n app.update_config(MyConfig)\n ```\n\n\n.. column::\n\n It even could be instantiated.\n\n.. column::\n\n ```python\n app.update_config(MyConfig())\n ```\n\n### Type casting\n\nWhen loading from environment variables, Sanic will attempt to cast the values to expected Python types. This particularly applies to:\n\n- `int`\n- `float`\n- `bool`\n\nIn regards to `bool`, the following _case insensitive_ values are allowed:\n\n- **`True`**: `y`, `yes`, `yep`, `yup`, `t`, `true`, `on`, `enable`, `enabled`, `1`\n- **`False`**: `n`, `no`, `f`, `nope`, `false`, `off`, `disable`, `disabled`, `0`\n\nIf a value cannot be cast, it will default to a `str`.\n\n.. column::\n\n Additionally, Sanic can be configured to cast additional types using additional type converters. This should be any callable that returns the value or raises a `ValueError`.\n\n *Added in v21.12*\n\n.. column::\n\n ```python\n app = Sanic(..., config=Config(converters=[UUID]))\n ```\n\n#### Advanced Type Converters\n\n.. new:: New in v25.12\n\n This feature was added in version 25.12\n\n.. column::\n\n For more sophisticated conversion logic that needs access to the full environment variable context, you can use `DetailedConverter`. This abstract base class provides access to the full environment variable key, the raw value, and the current config defaults.\n\n This is useful when you need to:\n - Cast values to the type of their defaults\n - Perform validation based on the variable name pattern\n - Use default values for fallback logic\n - Access configuration context during conversion\n\n.. column::\n\n ```python\n from sanic.config import DetailedConverter\n\n class DefaultsTypeCastingConverter(DetailedConverter):\n def __call__(self, full_key: str, config_key: str, value: str, defaults: dict):\n try:\n if config_key in defaults:\n return type(defaults[config_key])(value)\n except (ValueError, TypeError) as e:\n raise TypeError(f\"Configuration environment variable '{full_key}' type mismatch: expected\"\n f\" {type(defaults[config_key]).__name__}, got {type(value).__name__}\") from e\n\n app = Sanic(..., config=Config(converters=[DefaultsTypeCastingConverter()]))\n ```\n\n.. column::\n\n The `DetailedConverter.__call__` method receives four parameters:\n\n - `full_key`: The full environment variable name with prefix (e.g., \"SANIC_DATABASE_URL\")\n - `config_key`: The config key without prefix (e.g., \"DATABASE_URL\")\n - `value`: The raw string value from the environment\n - `defaults`: The current default configuration values\n\n.. column::\n\n ```python\n class ValidationConverter(DetailedConverter):\n def __call__(self, full_key: str, config_key: str, value: str, defaults: dict):\n if config_key.endswith('_PORT'):\n port = int(value)\n if not 1 <= port <= 65535:\n raise ValueError(f\"Invalid port: {port}\")\n return port\n raise ValueError # Let other converters handle it\n ```\n\n## Builtin values\n\n| **Variable** | **Default** | **Description** |\n|---------------------------|------------------|---------------------------------------------------------------------------------------------------------------------------------------|\n| ACCESS_LOG | True | Disable or enable access log |\n| AUTO_EXTEND | True | Control whether [Sanic Extensions](../../plugins/sanic-ext/getting-started.md) will load if it is in the existing virtual environment |\n| AUTO_RELOAD | True | Control whether the application will automatically reload when a file changes |\n| EVENT_AUTOREGISTER | True | When `True` using the `app.event()` method on a non-existing signal will automatically create it and not raise an exception |\n| FALLBACK_ERROR_FORMAT | html | Format of error response if an exception is not caught and handled |\n| FORWARDED_FOR_HEADER | X-Forwarded-For | The name of \"X-Forwarded-For\" HTTP header that contains client and proxy ip |\n| FORWARDED_SECRET | None | Used to securely identify a specific proxy server (see below) |\n| GRACEFUL_SHUTDOWN_TIMEOUT | 15.0 | How long to wait to force close non-idle connection (sec) |\n| INSPECTOR | False | Whether to enable the Inspector |\n| INSPECTOR_HOST | localhost | The host for the Inspector |\n| INSPECTOR_PORT | 6457 | The port for the Inspector |\n| INSPECTOR_TLS_KEY | - | The TLS key for the Inspector |\n| INSPECTOR_TLS_CERT | - | The TLS certificate for the Inspector |\n| INSPECTOR_API_KEY | - | The API key for the Inspector |\n| KEEP_ALIVE_TIMEOUT | 120 | How long to hold a TCP connection open (sec) |\n| KEEP_ALIVE | True | Disables keep-alive when False |\n| MOTD | True | Whether to display the MOTD (message of the day) at startup |\n| MOTD_DISPLAY | {} | Key/value pairs to display additional, arbitrary data in the MOTD |\n| NOISY_EXCEPTIONS | False | Force all `quiet` exceptions to be logged |\n| PROXIES_COUNT | None | The number of proxy servers in front of the app (e.g. nginx; see below) |\n| REAL_IP_HEADER | None | The name of \"X-Real-IP\" HTTP header that contains real client ip |\n| REGISTER | True | Whether the app registry should be enabled |\n| REQUEST_BUFFER_SIZE | 65536 | Request buffer size before request is paused, default is 64 Kib |\n| REQUEST_ID_HEADER | X-Request-ID | The name of \"X-Request-ID\" HTTP header that contains request/correlation ID |\n| REQUEST_MAX_SIZE | 100000000 | How big a request may be (bytes), default is 100 megabytes |\n| REQUEST_MAX_HEADER_SIZE | 8192 | How big a request header may be (bytes), default is 8192 bytes |\n| REQUEST_TIMEOUT | 60 | How long a request can take to arrive (sec) |\n| RESPONSE_TIMEOUT | 60 | How long a response can take to process (sec) |\n| USE_UVLOOP | True | Whether to override the loop policy to use `uvloop`. Supported only with `app.run`. |\n| WEBSOCKET_MAX_SIZE | 2^20 | Maximum size for incoming messages (bytes) |\n| WEBSOCKET_PING_INTERVAL | 20 | A Ping frame is sent every ping_interval seconds. |\n| WEBSOCKET_PING_TIMEOUT | 20 | Connection is closed when Pong is not received after ping_timeout seconds |\n\n\n.. tip:: FYI\n\n - The `USE_UVLOOP` value will be ignored if running with Gunicorn. Defaults to `False` on non-supported platforms (Windows).\n - The `WEBSOCKET_` values will be ignored if in ASGI mode.\n - v21.12 added: `AUTO_EXTEND`, `MOTD`, `MOTD_DISPLAY`, `NOISY_EXCEPTIONS`\n - v22.9 added: `INSPECTOR`\n - v22.12 added: `INSPECTOR_HOST`, `INSPECTOR_PORT`, `INSPECTOR_TLS_KEY`, `INSPECTOR_TLS_CERT`, `INSPECTOR_API_KEY`\n\n\n## Timeouts\n\n### REQUEST_TIMEOUT\n\nA request timeout measures the duration of time between the instant when a new open TCP connection is passed to the\nSanic backend server, and the instant when the whole HTTP request is received. If the time taken exceeds the\n`REQUEST_TIMEOUT` value (in seconds), this is considered a Client Error so Sanic generates an `HTTP 408` response\nand sends that to the client. Set this parameter's value higher if your clients routinely pass very large request payloads\nor upload requests very slowly.\n\n### RESPONSE_TIMEOUT\n\nA response timeout measures the duration of time between the instant the Sanic server passes the HTTP request to the Sanic App, and the instant a HTTP response is sent to the client. If the time taken exceeds the `RESPONSE_TIMEOUT` value (in seconds), this is considered a Server Error so Sanic generates an `HTTP 503` response and sends that to the client. Set this parameter's value higher if your application is likely to have long-running process that delay the\ngeneration of a response.\n\n### KEEP_ALIVE_TIMEOUT\n\n#### What is Keep Alive? And what does the Keep Alive Timeout value do?\n\n`Keep-Alive` is a HTTP feature introduced in `HTTP 1.1`. When sending a HTTP request, the client (usually a web browser application) can set a `Keep-Alive` header to indicate the http server (Sanic) to not close the TCP connection after it has send the response. This allows the client to reuse the existing TCP connection to send subsequent HTTP requests, and ensures more efficient network traffic for both the client and the server.\n\nThe `KEEP_ALIVE` config variable is set to `True` in Sanic by default. If you don't need this feature in your application, set it to `False` to cause all client connections to close immediately after a response is sent, regardless of the `Keep-Alive` header on the request.\n\nThe amount of time the server holds the TCP connection open is decided by the server itself. In Sanic, that value is configured using the `KEEP_ALIVE_TIMEOUT` value. By default, **it is set to 120 seconds**. This means that if the client sends a `Keep-Alive` header, the server will hold the TCP connection open for 120 seconds after sending the response, and the client can reuse the connection to send another HTTP request within that time.\n\nFor reference:\n\n* Apache httpd server default keepalive timeout = 5 seconds\n* Nginx server default keepalive timeout = 75 seconds\n* Nginx performance tuning guidelines uses keepalive = 15 seconds\n* Caddy server default keepalive timeout = 120 seconds\n* IE (5-9) client hard keepalive limit = 60 seconds\n* Firefox client hard keepalive limit = 115 seconds\n* Opera 11 client hard keepalive limit = 120 seconds\n* Chrome 13+ client keepalive limit > 300+ seconds\n\n## Proxy configuration\n\nSee [proxy configuration section](../advanced/proxy-headers.md)\n" }, { "path": "guide/content/en/guide/running/development.md", "content": "# Development\n\nThe first thing that should be mentioned is that the webserver that is integrated into Sanic is **not** just a development server. \n\nIt is production ready out-of-the-box, *unless you enable in debug mode*.\n\n## Debug mode\n\nBy setting the debug mode, Sanic will be more verbose in its output and will disable several run-time optimizations.\n\n```python\n# server.py\nfrom sanic import Sanic\nfrom sanic.response import json\n\napp = Sanic(__name__)\n\n@app.route(\"/\")\nasync def hello_world(request):\n return json({\"hello\": \"world\"})\n```\n```sh\nsanic server:app --host=0.0.0.0 --port=1234 --debug\n```\n\n\n.. danger:: \n \n Sanic's debug mode will slow down the server's performance, and is **NOT** intended for production environments.\n\n **DO NOT** enable debug mode in production.\n\n\n\n## Automatic Reloader\n\n.. column::\n\n Sanic offers a way to enable or disable the Automatic Reloader. The easiest way to enable it is using the CLI's `--reload` argument to activate the Automatic Reloader. Every time a Python file is changed, the reloader will restart your application automatically. This is very convenient while developing.\n\n .. note:: \n \n The reloader is only available when using Sanic's [worker manager](./manager.md). If you have disabled it using `--single-process` then the reloader will not be available to you.\n\n.. column::\n\n ```sh\n sanic path.to:app --reload\n ```\n You can also use the shorthand property\n ```sh\n sanic path.to:app -r\n ```\n\n\n.. column::\n\n If you have additional directories that you would like to automatically reload on file save (for example, a directory of HTML templates), you can add that using `--reload-dir`.\n\n.. column::\n\n ```sh\n sanic path.to:app --reload --reload-dir=/path/to/templates\n ```\n Or multiple directories, shown here using the shorthand properties\n ```sh\n sanic path.to:app -r -R /path/to/one -R /path/to/two\n ```\n\n\n## Development REPL\n\nThe Sanic CLI comes with a REPL (aka \"read-eval-print loop\") that can be used to interact with your application. This is useful for debugging and testing. A REPL is the interactive shell that you get when you run `python` without any arguments.\n\n.. column::\n\n You can start the REPL by passing the `--repl` argument to the Sanic CLI.\n\n.. column::\n\n ```sh\n sanic path.to.server:app --repl\n ```\n\n.. column::\n\n Or, perhaps more conveniently, when you run `--dev`, Sanic will automatically start the REPL for you. However, in this case you might be prompted to hit the \"ENTER\" key before actually starting the REPL.\n\n.. column::\n\n ```sh\n sanic path.to.server:app --dev\n ```\n\n![](/assets/images/repl.png)\n\nAs seen in the screenshot above, the REPL will automatically add a few variables to the global namespace. These are:\n\n- `app` - The Sanic application instance. This is the same instance that is passed to the `sanic` CLI.\n- `sanic` - The `sanic` module. This is the same module that is imported when you run `import sanic`.\n- `do` - A function that will create a mock `Request` object and pass it to your application. This is useful for testing your application from the REPL.\n- `client` - An instance of `httpx.Client` that is configured to make requests to your application. This is useful for testing your application from the REPL. **Note:** This is only available if `httpx` is installed in your environment.\n\n### Async/Await support\n\n.. column::\n\n The REPL supports `async`/`await` syntax. This means that you can use `await` in the REPL to wait for asynchronous operations to complete. This is useful for testing asynchronous code.\n\n.. column::\n\n ```python\n >>> await app.ctx.db.fetchval(\"SELECT 1\")\n 1 \n ```\n\n### The `app` variable\n\nYou need to keep in mind that the `app` variable is your app instance as it existed when the REPL was started. It is the instance that is loaded when running the CLI command. This means that any changes that are made to your source code and subsequently reloaded in the workers will not be reflected in the `app` variable. If you want to interact with the reloaded app instance, you will need to restart the REPL.\n\nHowever, it is also very useful to have access to the original app instance in the REPL for adhoc testing and debugging.\n\n### The `client` variable\n\nWhen [httpx](https://www.python-httpx.org/) is installed in your environment, the `client` variable will be available in the REPL. This is an instance of `httpx.Client` that is configured to make requests to your running application.\n\n.. column::\n\n To use it, simply call one of the HTTP methods on the client. See the [httpx documentation](https://www.python-httpx.org/api/#client) for more information.\n\n.. column::\n\n ```python\n >>> client.get(\"/\")\n \n ```\n\n### The `do` function\n\nAs discussed above, the `app` instance exists as it did at the time the REPL was started, and as was modified inside the REPL. Any changes to the instance that cause a server to be reloaded will not be reflected in the `app` variable. This is where the `do` function comes in.\n\nLet's say that you have modified your application inside the REPL to add a new route:\n\n```python\n>>> @app.get(\"/new-route\")\n... async def new_route(request):\n... return sanic.json({\"hello\": \"world\"})\n...\n>>>\n```\n\nYou can use the `do` function to mock out a request, and pass it to the application as if it were a real HTTP request. This will allow you to test your new route without having to restart the REPL.\n\n```python\n>>> await do(\"/new-route\")\nResult(request=, response=)\n```\n\nThe `do` function returns a `Result` object that contains the `Request` and `Response` objects that were returned by your application. It is a `NamedTuple`, so you can access the values by name:\n\n```python\n>>> result = await do(\"/new-route\")\n>>> result.request\n\n>>> result.response\n\n```\n\nOr, by destructuring the tuple:\n\n```python\n>>> request, response = await do(\"/new-route\")\n>>> request\n\n>>> response\n\n```\n\n### When to use `do` vs `client`?\n\n.. column::\n\n **Use `do` when ...**\n\n - You want to test a route that does not exist in the running application\n - You want to test a route that has been modified in the REPL\n - You make a change to your application inside the REPL\n\n.. column::\n\n **Use `client` when ...**\n\n - You want to test a route that already exists in the running application\n - You want to test a route that has been modified in your source code\n - You want to send an actual HTTP request to your application\n\n*Added in v23.12*\n\n## Complete development mode\n\n.. column::\n\n If you would like to be in debug mode **and** have the Automatic Reloader running, you can pass `dev=True`. This is equivalent to **debug + auto reload + REPL**.\n\n *Added in v22.3*\n\n.. column::\n\n ```sh\n sanic path.to:app --dev\n ```\n You can also use the shorthand property\n ```sh\n sanic path.to:app -d\n ```\n\nAdded to the `--dev` flag in v23.12 is the ability to start a REPL. See the [Development REPL](./development.md#development-repl) section for more information.\n \nAs of v23.12, the `--dev` flag is roughly equivalent to `--debug --reload --repl`. Using `--dev` will require you to expressly begin the REPL by hitting \"ENTER\", while passing the `--repl` flag explicitly starts it.\nBefore v23.12, the `--dev` flag is more similar to `--debug --reload`.\n\t\n.. column::\n\n If you would like to disable the REPL while using the `--dev` flag, you can pass `--no-repl`.\n\n.. column::\n\n ```sh\n sanic path.to:app --dev --no-repl\n ```\n\n## Automatic TLS certificate\n\nWhen running in `DEBUG` mode, you can ask Sanic to handle setting up localhost temporary TLS certificates. This is helpful if you want to access your local development environment with `https://`.\n\nThis functionality is provided by either [mkcert](https://github.com/FiloSottile/mkcert) or [trustme](https://github.com/python-trio/trustme). Both are good choices, but there are some differences. `trustme` is a Python library and can be installed into your environment with `pip`. This makes for easy envrionment handling, but it is not compatible when running a HTTP/3 server. `mkcert` might be a more involved installation process, but can install a local CA and make it easier to use.\n\n.. column::\n\n You can choose which platform to use by setting `config.LOCAL_CERT_CREATOR`. When set to `\"auto\"`, it will select either option, preferring `mkcert` if possible.\n\n.. column::\n\n ```python\n app.config.LOCAL_CERT_CREATOR = \"auto\"\n app.config.LOCAL_CERT_CREATOR = \"mkcert\"\n app.config.LOCAL_CERT_CREATOR = \"trustme\"\n ```\n\n.. column::\n\n Automatic TLS can be enabled at Sanic server run time:\n\n.. column::\n\n ```sh\n sanic path.to.server:app --auto-tls --debug\n ```\n\n.. warning:: \n\n Localhost TLS certificates (like those generated by both `mkcert` and `trustme`) are **NOT** suitable for production environments. If you are not familiar with how to obtain a *real* TLS certificate, checkout the [How to...](../how-to/tls.md) section.\n\n*Added in v22.6*\n" }, { "path": "guide/content/en/guide/running/inspector.md", "content": "# Inspector\n\nThe Sanic Inspector is a feature of Sanic Server. It is *only* available when running Sanic with the built-in [worker manager](./manager.md).\n\nIt is an HTTP application that *optionally* runs in the background of your application to allow you to interact with the running instance of your application.\n\n\n.. tip:: INFO\n\n The Inspector was introduced in limited capacity in v22.9, but the documentation on this page assumes you are using v22.12 or higher.\n\n\n## Getting Started\n\nThe inspector is disabled by default. To enable it, you have two options.\n\n.. column::\n\n Set a flag when creating your application instance.\n\n.. column::\n\n ```python\n app = Sanic(\"TestApp\", inspector=True)\n ```\n\n\n.. column::\n\n Or, set a configuration value.\n\n.. column::\n\n ```python\n app = Sanic(\"TestApp\")\n app.config.INSPECTOR = True\n ```\n\n\n\n.. warning:: \n\n If you are using the configuration value, it *must* be done early and before the main worker process starts. This means that it should either be an environment variable, or it should be set shortly after creating the application instance as shown above.\n\n\n\n## Using the Inspector\n\nOnce the inspector is running, you will have access to it via the CLI or by directly accessing its web API via HTTP.\n\n.. column::\n\n **Via CLI**\n ```sh\n sanic inspect\n ```\n\n.. column::\n\n **Via HTTP**\n ```sh\n curl http://localhost:6457\n ```\n\n\n\n.. note:: \n\n Remember, the Inspector is not running on your Sanic application. It is a seperate process, with a seperate application, and exposed on a seperate socket.\n\n\n\n## Built-in Commands\n\nThe Inspector comes with the following built-in commands. \n\n| CLI Command | HTTP Action | Description |\n|--------------------|------------------------------------|--------------------------------------------------------------------------|\n| `inspect` | `GET /` | Display basic details about the running application. |\n| `inspect reload` | `POST /reload` | Trigger a reload of all server workers. |\n| `inspect shutdown` | `POST /shutdown` | Trigger a shutdown of all processes. |\n| `inspect scale N` | `POST /scale`
`{\"replicas\": N}` | Scale the number of workers. Where `N` is the target number of replicas. |\n\n## Custom Commands\n\nThe Inspector is easily extendable to add custom commands (and endpoints).\n\n.. column::\n\n Subclass the `Inspector` class and create arbitrary methods. As long as the method name is not preceded by an underscore (`_`), then the name of the method will be a new subcommand on the inspector.\n\n.. column::\n\n ```python\n from sanic import json\n from sanic.worker.inspector import Inspector\n\n class MyInspector(Inspector):\n async def something(self, *args, **kwargs):\n print(args)\n print(kwargs)\n\n app = Sanic(\"TestApp\", inspector_class=MyInspector, inspector=True)\n ```\n\nThis will expose custom methods in the general pattern:\n\n- CLI: `sanic inspect `\n- HTTP: `POST /`\n\nIt is important to note that the arguments that the new method accepts are derived from how you intend to use the command. For example, the above `something` method accepts all positional and keyword based parameters.\n\n.. column::\n\n In the CLI, the positional and keyword parameters are passed as either positional or keyword arguments to your method. All values will be a `str` with the following exceptions:\n\n - A keyword parameter with no assigned value will be: `True`\n - Unless the parameter is prefixed with `no-`, then it will be: `False`\n\n.. column::\n\n ```sh\n sanic inspect something one two three --four --no-five --six=6\n ```\n In your application log console, you will see:\n ```\n ('one', 'two', 'three')\n {'four': True, 'five': False, 'six': '6'}\n ```\n\n\n.. column::\n\n The same can be achieved by hitting the API directly. You can pass arguments to the method by exposing them in a JSON payload. The only thing to note is that the positional arguments should be exposed as `{\"args\": [...]}`.\n\n.. column::\n\n ```sh\n curl http://localhost:6457/something \\\n --json '{\"args\":[\"one\", \"two\", \"three\"], \"four\":true, \"five\":false, \"six\":6}'\n ```\n In your application log console, you will see:\n ```\n ('one', 'two', 'three')\n {'four': True, 'five': False, 'six': 6}\n ```\n\n\n## Using in production\n\n\n.. danger:: \n\n Before exposing the Inspector on a product, please consider all of the options in this section carefully.\n\n\nWhen running Inspector on a remote production instance, you can protect the endpoints by requiring TLS encryption, and requiring API key authentication.\n\n### TLS encryption\n\n.. column::\n\n To the Inspector HTTP instance over TLS, pass the paths to your certificate and key.\n\n.. column::\n\n ```python\n app.config.INSPECTOR_TLS_CERT = \"/path/to/cert.pem\"\n app.config.INSPECTOR_TLS_KEY = \"/path/to/key.pem\"\n ```\n\n\n.. column::\n\n This will require use of the `--secure` flag, or `https://`.\n\n.. column::\n\n ```sh\n sanic inspect --secure --host=\n ```\n ```sh\n curl https://:6457\n ```\n\n### API Key Authentication\n\n.. column::\n\n You can secure the API with bearer token authentication.\n\n.. column::\n\n ```python\n app.config.INSPECTOR_API_KEY = \"Super-Secret-200\"\n ```\n\n\n.. column::\n\n This will require the `--api-key` parameter, or bearer token authorization header.\n\n.. column::\n\n ```sh\n sanic inspect --api-key=Super-Secret-200\n ```\n ```sh\n curl http://localhost:6457 -H \"Authorization: Bearer Super-Secret-200\"\n ```\n\n## Configuration\n\nSee [configuration](./configuration.md)\n" }, { "path": "guide/content/en/guide/running/manager.md", "content": "---\ntitle: Worker Manager\n---\n\n# Worker Manager\n\nThe worker manager and its functionality was introduced in version 22.9.\n\n*The details of this section are intended for more advanced usages and **not** necessary to get started.*\n\nThe purpose of the manager is to create consistency and flexibility between development and production environments. Whether you intend to run a single worker, or multiple workers, whether with, or without auto-reload: the experience will be the same.\n\nIn general it looks like this:\n\n![](https://user-images.githubusercontent.com/166269/178677618-3b4089c3-6c6a-4ecc-8d7a-7eba2a7f29b0.png)\n\nWhen you run Sanic, the main process instantiates a `WorkerManager`. That manager is in charge of running one or more `WorkerProcess`. There generally are two kinds of processes:\n\n- server processes, and\n- non-server processes.\n\nFor the sake of ease, the User Guide generally will use the term \"worker\" or \"worker process\" to mean a server process, and \"Manager\" to mean the single worker manager running in your main process.\n\n## How Sanic Server starts processes\n\nSanic will start processes using the [spawn](https://docs.python.org/3/library/multiprocessing.html#contexts-and-start-methods) start method. This means that for every process/worker, the global scope of your application will be run on its own thread. The practical impact of this that *if* you do not run Sanic with the CLI, you will need to nest the execution code inside a block to make sure it only runs on `__main__`.\n\n```python\nif __name__ == \"__main__\":\n app.run()\n```\n\nIf you do not, you are likely to see an error message like this:\n\n```\nsanic.exceptions.ServerError: Sanic server could not start: [Errno 98] Address already in use.\n\nThis may have happened if you are running Sanic in the global scope and not inside of a `if __name__ == \"__main__\"` block.\n\nSee more information: https://sanic.dev/en/guide/deployment/manager.html#how-sanic-server-starts-processes\n```\n\nThe likely fix for this problem is nesting your Sanic run call inside of the `__name__ == \"__main__\"` block. If you continue to receive this message after nesting, or if you see this while using the CLI, then it means the port you are trying to use is not available on your machine and you must select another port.\n\n### Starting a worker\n\nAll worker processes *must* send an acknowledgement when starting. This happens under the hood, and you as a developer do not need to do anything. However, the Manager will exit with a status code `1` if one or more workers do not send that `ack` message, or a worker process throws an exception while trying to start. If no exceptions are encountered, the Manager will wait for up to thirty (30) seconds for the acknowledgement.\n\n.. column::\n\n In the situation when you know that you will need more time to start, you can monkeypatch the Manager. The threshold does not include anything inside of a listener, and is limited to the execution time of everything in the global scope of your application.\n\n If you run into this issue, it may indicate a need to look deeper into what is causing the slow startup.\n\n.. column::\n\n ```python\n from sanic.worker.manager import WorkerManager\n\n WorkerManager.THRESHOLD = 100 # Value is in 0.1s\n ```\n\nSee [worker ack](#worker-ack) for more information.\n\n.. column::\n\n As stated above, Sanic will use [spawn](https://docs.python.org/3/library/multiprocessing.html#contexts-and-start-methods) to start worker processes. If you would like to change this behavior and are aware of the implications of using different start methods, you can modify as shown here.\n\n.. column::\n\n ```python\n from sanic import Sanic\n\n Sanic.start_method = \"fork\"\n ```\n\n\n### Worker ack\n\nWhen all of your workers are running in a subprocess a potential problem is created: deadlock. This can occur when the child processes cease to function, but the main process is unaware that this happened. Therefore, Sanic servers will automatically send an `ack` message (short for acknowledge) to the main process after startup.\n\nIn version 22.9, the `ack` timeout was short and limited to `5s`. In version 22.12, the timeout was lengthened to `30s`. If your application is shutting down after thirty seconds then it might be necessary to manually increase this threshhold.\n\n.. column::\n\n The value of `WorkerManager.THRESHOLD` is in `0.1s` increments. Therefore, to set it to one minute, you should set the value to `600`.\n\n This value should be set as early as possible in your application, and should ideally happen in the global scope. Setting it after the main process has started will not work.\n\n.. column::\n\n ```python\n from sanic.worker.manager import WorkerManager\n\n WorkerManager.THRESHOLD = 600\n ```\n\n### Zero downtime restarts\n\nBy default, when restarting workers, Sanic will teardown the existing process first before starting a new one. \n\nIf you are intending to use the restart functionality in production then you may be interested in having zero-downtime reloading. This can be accomplished by forcing the reloader to change the order to start a new process, wait for it to [ack](#worker-ack), and then teardown the old process.\n\n.. column::\n\n From the multiplexer, use the `zero_downtime` argument\n\n.. column::\n\n ```python\n app.m.restart(zero_downtime=True)\n ```\n\n*Added in v22.12*\n\n## Using shared context between worker processes\n\nPython provides a few methods for [exchanging objects](https://docs.python.org/3/library/multiprocessing.html#exchanging-objects-between-processes), [synchronizing](https://docs.python.org/3/library/multiprocessing.html#synchronization-between-processes), and [sharing state](https://docs.python.org/3/library/multiprocessing.html#sharing-state-between-processes) between processes. This usually involves objects from the `multiprocessing` and `ctypes` modules.\n\nIf you are familiar with these objects and how to work with them, you will be happy to know that Sanic provides an API for sharing these objects between your worker processes. If you are not familiar, you are encouraged to read through the Python documentation linked above and try some of the examples before proceeding with implementing shared context.\n\nSimilar to how [application context](../basics/app.md#application-context) allows an applicaiton to share state across the lifetime of the application with `app.ctx`, shared context provides the same for the special objects mentioned above. This context is available as `app.shared_ctx` and should **ONLY** be used to share objects intended for this purpose.\n\nThe `shared_ctx` will:\n\n- *NOT* share regular objects like `int`, `dict`, or `list`\n- *NOT* share state between Sanic instances running on different machines\n- *NOT* share state to non-worker processes\n- **only** share state between server workers managed by the same Manager\n\nAttaching an inappropriate object to `shared_ctx` will likely result in a warning, and not an error. You should be careful to not accidentally add an unsafe object to `shared_ctx` as it may not work as expected. If you are directed here because of one of those warnings, you might have accidentally used an unsafe object in `shared_ctx`.\n\n.. column::\n\n In order to create a shared object you **must** create it in the main process and attach it inside of the `main_process_start` listener.\n\n.. column::\n\n ```python\n from multiprocessing import Queue\n\n @app.main_process_start\n async def main_process_start(app):\n app.shared_ctx.queue = Queue()\n ```\n\nTrying to attach to the `shared_ctx` object outside of this listener may result in a `RuntimeError`.\n\n.. column::\n\n After creating the objects in the `main_process_start` listener and attaching to the `shared_ctx`, they will be available in your workers wherever the application instance is available (example: listeners, middleware, request handlers).\n\n.. column::\n\n ```python\n from multiprocessing import Queue\n\n @app.get(\"\")\n async def handler(request):\n request.app.shared_ctx.queue.put(1)\n ...\n ```\n\n## Access to the multiplexer\n\nThe application instance has access to an object that provides access to interacting with the Manager and other worker processes. The object is attached as the `app.multiplexer` property, but it is more easily accessed by its alias: `app.m`.\n\n.. column::\n\n For example, you can get access to the current worker state.\n\n.. column::\n\n ```python\n @app.on_request\n async def print_state(request: Request):\n print(request.app.m.name)\n print(request.app.m.pid)\n print(request.app.m.state)\n ```\n ```\n Sanic-Server-0-0\n 99999\n {'server': True, 'state': 'ACKED', 'pid': 99999, 'start_at': datetime.datetime(2022, 10, 1, 0, 0, 0, 0, tzinfo=datetime.timezone.utc), 'starts': 2, 'restart_at': datetime.datetime(2022, 10, 1, 0, 0, 12, 861332, tzinfo=datetime.timezone.utc)}\n ```\n\n\n.. column::\n\n The `multiplexer` also has access to terminate the Manager, or restart worker processes\n\n.. column::\n\n ```python\n # shutdown the entire application and all processes\n app.m.name.terminate()\n\n # restart the current worker only\n app.m.name.restart()\n\n # restart specific workers only (comma delimited)\n app.m.name.restart(\"Sanic-Server-4-0,Sanic-Server-7-0\")\n\n # restart ALL workers\n app.m.name.restart(all_workers=True) # Available v22.12+\n ```\n\n## Worker state\n\n.. column::\n\n As shown above, the `multiplexer` has access to report upon the state of the current running worker. However, it also contains the state for ALL processes running.\n\n.. column::\n\n ```python\n @app.on_request\n async def print_state(request: Request):\n print(request.app.m.workers)\n ```\n ```\n {\n 'Sanic-Main': {'pid': 99997},\n 'Sanic-Server-0-0': {\n 'server': True,\n 'state': 'ACKED',\n 'pid': 9999,\n 'start_at': datetime.datetime(2022, 10, 1, 0, 0, 0, 0, tzinfo=datetime.timezone.utc),\n 'starts': 2,\n 'restart_at': datetime.datetime(2022, 10, 1, 0, 0, 12, 861332, tzinfo=datetime.timezone.utc)\n },\n 'Sanic-Reloader-0': {\n 'server': False,\n 'state': 'STARTED',\n 'pid': 99998,\n 'start_at': datetime.datetime(2022, 10, 1, 0, 0, 0, 0, tzinfo=datetime.timezone.utc),\n 'starts': 1\n }\n }\n ```\n\nThe possible states are:\n\n- `NONE` - The worker has been created, but there is no process yet\n- `IDLE` - The process has been created, but is not running yet\n- `STARTING` - The process is starting\n- `STARTED` - The process has started\n- `ACKED` - The process has started and sent an acknowledgement (usually only for server processes)\n- `JOINED` - The process has exited and joined the main process\n- `TERMINATED` - The process has exited and terminated\n- `RESTARTING` - The process is restarting\n- `FAILED` - The process encountered an exception and is no longer running\n- `COMPLETED` - The process has completed its work and exited successfully\n\n## Built-in non-server processes\n\nAs mentioned, the Manager also has the ability to run non-server processes. Sanic comes with two built-in types of non-server processes, and allows for [creating custom processes](#running-custom-processes).\n\nThe two built-in processes are\n\n- the [auto-reloader](./development.md#automatic-reloader), optionally enabled to watch the file system for changes and trigger a restart\n- [inspector](#inspector), optionally enabled to provide external access to the state of the running instance\n\n## Inspector\n\nSanic has the ability to expose the state and the functionality of the `multiplexer` to the CLI. Currently, this requires the CLI command to be run on the same machine as the running Sanic instance. By default the inspector is disabled.\n\n.. column::\n\n To enable it, set the config value to `True`.\n\n.. column::\n\n ```python\n app.config.INSPECTOR = True\n ```\n\nYou will now have access to execute any of these CLI commands:\n\n```\nsanic inspect reload Trigger a reload of the server workers\nsanic inspect shutdown Shutdown the application and all processes\nsanic inspect scale N Scale the number of workers to N\nsanic inspect Run a custom command\n```\n\n![](https://user-images.githubusercontent.com/166269/190099384-2f2f3fae-22d5-4529-b279-8446f6b5f9bd.png)\n\n.. column::\n\n This works by exposing a small HTTP service on your machine. You can control the location using configuration values:\n\n.. column::\n\n ```python\n app.config.INSPECTOR_HOST = \"localhost\"\n app.config.INSPECTOR_PORT = 6457\n ```\n\n[Learn more](./inspector.md) to find out what is possible with the Inspector.\n\n## Running custom processes\n\nTo run a managed custom process on Sanic, you must create a callable. If that process is meant to be long-running, then it should handle a shutdown call by a `SIGINT` or `SIGTERM` signal.\n\n.. column::\n\n The simplest method for doing that in Python will be to just wrap your loop in `KeyboardInterrupt`.\n\n If you intend to run another application, like a bot, then it is likely that it already has capability to handle this signal and you likely do not need to do anything.\n\n.. column::\n\n ```python\n from time import sleep\n\n def my_process(foo):\n try:\n while True:\n sleep(1)\n except KeyboardInterrupt:\n print(\"done\")\n ```\n\n\n.. column::\n\n That callable must be registered in the `main_process_ready` listener. It is important to note that is is **NOT** the same location that you should register [shared context](#using-shared-context-between-worker-processes) objects.\n\n.. column::\n\n ```python\n @app.main_process_ready\n async def ready(app: Sanic, _):\n # app.manager.manage(, , )\n app.manager.manage(\"MyProcess\", my_process, {\"foo\": \"bar\"})\n ```\n\n### Transient v. durable processes\n\n.. column::\n\n When you manage a process with the `manage` method, you have the option to make it transient or durable. A transient process will be restarted by the auto-reloader, and a durable process will not.\n \n By default, all processes are durable.\n \n.. column::\n\n ```python\n @app.main_process_ready\n async def ready(app: Sanic, _):\n app.manager.manage(\n \"MyProcess\",\n my_process,\n {\"foo\": \"bar\"},\n transient=True,\n )\n ```\n\n\n### Tracked v. untracked processes\n\nOut of the box, Sanic will track the state of all processes. This means that you can access the state of the process from the [multiplexer](./manager.md#access-to-the-multiplexer) object, or from the [Inspector](./manager.md#inspector).\n\nSee [worker state](./manager.md#worker-state) for more information.\n \nSometimes it is helpful to run background processes that are not long-running. You run them once until completion and then they exit. Upon completion, they will either be in `FAILED` or `COMPLETED` state.\n \n.. column::\n\n When you are running a non-long-running process, you can opt out of tracking it by setting `tracked=False` in the `manage` method. This means that upon completion of the process it will be removed from the list of tracked processes. You will only be able to check the state of the process while it is running.\n \n.. column::\n\n ```python\n @app.main_process_ready\n async def ready(app: Sanic, _):\n app.manager.manage(\n \"OneAndDone\",\n do_once,\n {},\n tracked=False,\n )\n ```\n\n*Added in v23.12*\n\n### Restartable custom processes\n\nA custom process that is transient will **always** be restartable. That means the auto-restart will work as expected. However, what if you want to be able to *manually* restart a process, but not have it be restarted by the auto-reloader?\n \n.. column::\n\n In this scenario, you can set `restartable=True` in the `manage` method. This will allow you to manually restart the process, but it will not be restarted by the auto-reloader.\n \n.. column::\n\n ```python\n @app.main_process_ready\n async def ready(app: Sanic, _):\n app.manager.manage(\n \"MyProcess\",\n my_process,\n {\"foo\": \"bar\"},\n restartable=True,\n )\n ```\n \n.. column::\n\n You could now manually restart that process from the multiplexer.\n \n.. column::\n\n ```python\n @app.get(\"/restart\")\n async def restart_handler(request: Request):\n request.app.m.restart(\"Sanic-MyProcess-0\")\n return json({\"foo\": request.app.m.name})\n ```\n \n*Added in v23.12*\n\n### On the fly process management\n\nCustom processes are usually added in the `main_process_ready` listener. However, there may be times when you want to add a process after the application has started. For example, you may want to add a process from a request handler. The multiplexer provides a method for doing this.\n \n.. column::\n\n Once you have a reference to the multiplexer, you can call `manage` to add a process. It works the same as the `manage` method on the Manager.\n \n.. column::\n\n ```python\n @app.post(\"/start\")\n async def start_handler(request: Request):\n request.app.m.manage(\n \"MyProcess\",\n my_process,\n {\"foo\": \"bar\"},\n workers=2,\n )\n return json({\"foo\": request.app.m.name})\n ```\n \n*Added in v23.12*\n\n## Single process mode\n\n.. column::\n\n If you would like to opt out of running multiple processes, you can run Sanic in a single process only. In this case, the Manager will not run. You will also not have access to any features that require processes (auto-reload, the inspector, etc).\n\n.. column::\n\n ```sh\n sanic path.to.server:app --single-process\n ```\n ```python\n if __name__ == \"__main__\":\n app.run(single_process=True)\n ```\n ```python\n if __name__ == \"__main__\":\n app.prepare(single_process=True)\n Sanic.serve_single()\n ```\n\n## Sanic and multiprocessing\n\nSanic makes heavy use of the [`multiprocessing` module](https://docs.python.org/3/library/multiprocessing.html) to manage the worker processes. You should generally avoid lower level usage of this module (like setting the start method) as it may interfere with the functionality of Sanic.\n\n### Start methods in Python\n\nBefore explaining what Sanic tries to do, it is important to understand what the `start_method` is and why it is important. Python generally allows for three different methods of starting a process:\n\n- `fork`\n- `spawn`\n- `forkserver`\n\nThe `fork` and `forkserver` methods are only available on Unix systems, and `spawn` is the only method available on Windows. On Unix systems where you have a choice, `fork` is generally the default system method.\n\nYou are encouraged to read the [Python documentation](https://docs.python.org/3/library/multiprocessing.html#contexts-and-start-methods) to learn more about the differences between these methods. However, the important thing to know is that `fork` basically copies the entire memory of the parent process into the child process, whereas `spawn` will create a new process and then load the application into that process. This is the reason why you need to nest your Sanic `run` call inside of the `__name__ == \"__main__\"` block if you are not using the CLI.\n\n### Sanic and start methods\n\nBy default, Sanic will try and use `spawn` as the start method. This is because it is the only method available on Windows, and it is the safest method on Unix systems. \n\n.. column::\n\n However, if you are running Sanic on a Unix system and you would like to use `fork` instead, you can do so by setting the `start_method` on the `Sanic` class. You will want to do this as early as possible in your application, and ideally in the global scope before you import any other modules.\n\n.. column::\n\n ```python\n from sanic import Sanic\n \n Sanic.start_method = \"fork\"\n ```\n\n### Overcoming a `RuntimeError`\n\nYou might have received a `RuntimeError` that looks like this:\n\n```\nRuntimeError: Start method 'spawn' was requested, but 'fork' was already set.\n```\n\nIf so, that means somewhere in your application you are trying to set the start method that conflicts with what Sanic is trying to do. You have a few options to resolve this:\n\n.. column::\n\n **OPTION 1:** You can tell Sanic that the start method has been set and to not try and set it again.\n\n.. column::\n\n ```python\n from sanic import Sanic\n\n Sanic.START_METHOD_SET = True\n ```\n\n.. column::\n\n **OPTION 2:** You could tell Sanic that you intend to use `fork` and to not try and set it to `spawn`.\n\n.. column::\n\n ```python\n from sanic import Sanic\n\n Sanic.start_method = \"fork\"\n ```\n\n.. column::\n\n **OPTION 3:** You can tell Python to use `spawn` instead of `fork` by setting the `multiprocessing` start method.\n\n.. column::\n\n ```python\n import multiprocessing\n\n multiprocessing.set_start_method(\"spawn\")\n ```\n\nIn any of these options, you should run this code as early as possible in your application. Depending upon exactly what your specific scenario is, you may need to combine some of the options.\n\n.. note::\n\n The potential issues that arise from this problem are usually easily solved by just allowing Sanic to be in charge of multiprocessing. This usually means making use of the `main_process_start` and `main_process_ready` listeners to deal with multiprocessing issues. For example, you should move instantiating multiprocessing primitives that do a lot of work under the hood from the global scope and into a listener.\n \n ```python\n # This is BAD; avoid the global scope\n from multiprocessing import Queue\n \n q = Queue()\n ```\n \n ```python\n # This is GOOD; the queue is made in a listener and shared to all the processes on the shared_ctx\n from multiprocessing import Queue\n\n @app.main_process_start\n async def main_process_start(app):\n app.shared_ctx.q = Queue()\n ```\n" }, { "path": "guide/content/en/guide/running/running.md", "content": "---\ntitle: Running Sanic\n---\n\n# Running Sanic\n\nSanic ships with its own internal web server. Under most circumstances, this is the preferred method for deployment. In addition, you can also deploy Sanic as an ASGI app bundled with an ASGI-able web server.\n\n## Sanic Server\n\nThe main way to run Sanic is to use the included [CLI](#sanic-cli).\n\n```sh\nsanic path.to.server:app\n```\n\nIn this example, Sanic is instructed to look for a python module called `path.to.server`. Inside of that module, it will look for a global variable called `app`, which should be an instance of `Sanic(...)`.\n\n```python\n# ./path/to/server.py\nfrom sanic import Sanic, Request, json\n\napp = Sanic(\"TestApp\")\n\n@app.get(\"/\")\nasync def handler(request: Request):\n return json({\"foo\": \"bar\"})\n```\n\nYou may also dropdown to the [lower level API](#low-level-apprun) to call `app.run` as a script. However, if you choose this option you should be more comfortable handling issues that may arise with `multiprocessing`.\n\n### Workers\n\n.. column::\n\n By default, Sanic runs a main process and a single worker process (see [worker manager](./manager.md) for more details).\n\n To crank up the juice, just specify the number of workers in the run arguments.\n\n.. column::\n\n ```sh\n sanic server:app --host=0.0.0.0 --port=1337 --workers=4\n ```\n\nSanic will automatically spin up multiple processes and route traffic between them. We recommend as many workers as you have available processors.\n\n.. column::\n\n The easiest way to get the maximum CPU performance is to use the `--fast` option. This will automatically run the maximum number of workers given the system constraints.\n\n *Added in v21.12*\n\n.. column::\n\n ```sh\n sanic server:app --host=0.0.0.0 --port=1337 --fast\n ```\n\nIn version 22.9, Sanic introduced a new worker manager to provide more consistency and flexibility between development and production servers. Read [about the manager](./manager.md) for more details about workers.\n\n.. column::\n\n If you only want to run Sanic with a single process, specify `single_process` in the run arguments. This means that auto-reload, and the worker manager will be unavailable.\n\n *Added in v22.9*\n\n.. column::\n\n ```sh\n sanic server:app --host=0.0.0.0 --port=1337 --single-process\n ```\n\n### Running via command\n\n#### Sanic CLI\n\nUse `sanic --help` to see all the options.\n\n\n.. attrs::\n :title: Sanic CLI help output\n :class: details\n\n ```text\n $ sanic --help\n\n ▄███ █████ ██ ▄█▄ ██ █ █ ▄██████████\n ██ █ █ █ ██ █ █ ██\n ▀███████ ███▄ ▀ █ █ ██ ▄ █ ██\n ██ █████████ █ ██ █ █ ▄▄\n ████ ████████▀ █ █ █ ██ █ ▀██ ███████\n\n To start running a Sanic application, provide a path to the module, where\n app is a Sanic() instance:\n\n $ sanic path.to.server:app\n\n Or, a path to a callable that returns a Sanic() instance:\n\n $ sanic path.to.factory:create_app --factory\n\n Or, a path to a directory to run as a simple HTTP server:\n\n $ sanic ./path/to/static --simple\n\n Required\n ========\n Positional:\n module Path to your Sanic app. Example: path.to.server:app\n If running a Simple Server, path to directory to serve. Example: ./\n\n Optional\n ========\n General:\n -h, --help show this help message and exit\n --version show program's version number and exit\n\n Application:\n --factory Treat app as an application factory, i.e. a () -> callable\n -s, --simple Run Sanic as a Simple Server, and serve the contents of a directory\n (module arg should be a path)\n --inspect Inspect the state of a running instance, human readable\n --inspect-raw Inspect the state of a running instance, JSON output\n --trigger-reload Trigger worker processes to reload\n --trigger-shutdown Trigger all processes to shutdown\n\n HTTP version:\n --http {1,3} Which HTTP version to use: HTTP/1.1 or HTTP/3. Value should\n be either 1, or 3. [default 1]\n -1 Run Sanic server using HTTP/1.1\n -3 Run Sanic server using HTTP/3\n\n Socket binding:\n -H HOST, --host HOST\n Host address [default 127.0.0.1]\n -p PORT, --port PORT\n Port to serve on [default 8000]\n -u UNIX, --unix UNIX\n location of unix socket\n\n TLS certificate:\n --cert CERT Location of fullchain.pem, bundle.crt or equivalent\n --key KEY Location of privkey.pem or equivalent .key file\n --tls DIR TLS certificate folder with fullchain.pem and privkey.pem\n May be specified multiple times to choose multiple certificates\n --tls-strict-host Only allow clients that send an SNI matching server certs\n\n Worker:\n -w WORKERS, --workers WORKERS\n Number of worker processes [default 1]\n --fast Set the number of workers to max allowed\n --single-process Do not use multiprocessing, run server in a single process\n --legacy Use the legacy server manager\n --access-logs Display access logs\n --no-access-logs No display access logs\n\n Development:\n --debug Run the server in debug mode\n -r, --reload, --auto-reload\n Watch source directory for file changes and reload on changes\n -R PATH, --reload-dir PATH\n Extra directories to watch and reload on changes\n -d, --dev debug + auto reload\n --auto-tls Create a temporary TLS certificate for local development (requires mkcert or trustme)\n\n Output:\n --coffee Uhm, coffee?\n --no-coffee No uhm, coffee?\n --motd Show the startup display\n --no-motd No show the startup display\n -v, --verbosity Control logging noise, eg. -vv or --verbosity=2 [default 0]\n --noisy-exceptions Output stack traces for all exceptions\n --no-noisy-exceptions\n No output stack traces for all exceptions\n\n ```\n\n\n#### As a module\n\n.. column::\n\n Sanic applications can also be called directly as a module.\n\n.. column::\n\n ```bash\n python -m sanic server.app --host=0.0.0.0 --port=1337 --workers=4\n ```\n\n#### Using a factory\n\nA very common solution is to develop your application *not* as a global variable, but instead using the factory pattern. In this context, \"factory\" means a function that returns an instance of `Sanic(...)`.\n\n.. column::\n\n Suppose that you have this in your `server.py`\n\n.. column::\n\n ```python\n from sanic import Sanic\n\n def create_app() -> Sanic:\n app = Sanic(\"MyApp\")\n\n return app\n ```\n\n\n.. column::\n\n You can run this application now by referencing it in the CLI explicitly as a factory:\n\n.. column::\n\n ```sh\n sanic server:create_app --factory\n ```\n Or, explicitly like this:\n ```sh\n sanic \"server:create_app()\"\n ```\n Or, implicitly like this:\n ```sh\n sanic server:create_app\n ```\n\n *Implicit command added in v23.3*\n\n### Low level `app.run`\n\nWhen using `app.run` you will just call your Python file like any other script.\n\n.. column::\n\n `app.run` must be properly nested inside of a name-main block.\n\n.. column::\n\n ```python\n # server.py\n app = Sanic(\"MyApp\")\n\n if __name__ == \"__main__\":\n app.run()\n ```\n\n\n\n.. danger:: \n\n Be *careful* when using this pattern. A very common mistake is to put too much logic inside of the `if __name__ == \"__main__\":` block.\n\n 🚫 This is a mistake\n\n ```python\n from sanic import Sanic\n from my.other.module import bp\n\n app = Sanic(\"MyApp\")\n\n if __name__ == \"__main__\":\n app.blueprint(bp)\n app.run()\n ```\n\n If you do this, your [blueprint](../best-practices/blueprints.md) will not be attached to your application. This is because the `__main__` block will only run on Sanic's main worker process, **NOT** any of its [worker processes](../deployment/manager.md). This goes for anything else that might impact your application (like attaching listeners, signals, middleware, etc). The only safe operations are anything that is meant for the main process, like the `app.main_*` listeners.\n\n Perhaps something like this is more appropriate:\n\n ```python\n from sanic import Sanic\n from my.other.module import bp\n\n app = Sanic(\"MyApp\")\n\n if __name__ == \"__mp_main__\":\n app.blueprint(bp)\n elif __name__ == \"__main__\":\n app.run()\n ```\n\n\nTo use the low-level `run` API, after defining an instance of `sanic.Sanic`, we can call the run method with the following keyword arguments:\n\n| Parameter | Default | Description |\n| :-------------------: | :--------------: | :---------------------------------------------------------------------------------------- |\n| **host** | `\"127.0.0.1\"` | Address to host the server on. |\n| **port** | `8000` | Port to host the server on. |\n| **unix** | `None` | Unix socket name to host the server on (instead of TCP). |\n| **dev** | `False` | Equivalent to `debug=True` and `auto_reload=True`. |\n| **debug** | `False` | Enables debug output (slows server). |\n| **ssl** | `None` | SSLContext for SSL encryption of worker(s). |\n| **sock** | `None` | Socket for the server to accept connections from. |\n| **workers** | `1` | Number of worker processes to spawn. Cannot be used with fast. |\n| **loop** | `None` | An asyncio-compatible event loop. If none is specified, Sanic creates its own event loop. |\n| **protocol** | `HttpProtocol` | Subclass of asyncio.protocol. |\n| **version** | `HTTP.VERSION_1` | The HTTP version to use (`HTTP.VERSION_1` or `HTTP.VERSION_3`). |\n| **access_log** | `True` | Enables log on handling requests (significantly slows server). |\n| **auto_reload** | `None` | Enables auto-reload on the source directory. |\n| **reload_dir** | `None` | A path or list of paths to directories the auto-reloader should watch. |\n| **noisy_exceptions** | `None` | Whether to set noisy exceptions globally. None means leave as default. |\n| **motd** | `True` | Whether to display the startup message. |\n| **motd_display** | `None` | A dict with extra key/value information to display in the startup message |\n| **fast** | `False` | Whether to maximize worker processes. Cannot be used with workers. |\n| **verbosity** | `0` | Level of logging detail. Max is 2. |\n| **auto_tls** | `False` | Whether to auto-create a TLS certificate for local development. Not for production. |\n| **single_process** | `False` | Whether to run Sanic in a single process. |\n\n.. column::\n\n For example, we can turn off the access log in order to increase performance, and bind to a custom host and port.\n\n.. column::\n\n ```python\n # server.py\n app = Sanic(\"MyApp\")\n\n if __name__ == \"__main__\":\n app.run(host='0.0.0.0', port=1337, access_log=False)\n ```\n\n\n.. column::\n\n Now, just execute the python script that has `app.run(...)`\n\n.. column::\n\n ```sh\n python server.py\n ```\n\nFor a slightly more advanced implementation, it is good to know that `app.run` will call `app.prepare` and `Sanic.serve` under the hood.\n\n.. column::\n\n Therefore, these are equivalent:\n\n.. column::\n\n ```python\n if __name__ == \"__main__\":\n app.run(host='0.0.0.0', port=1337, access_log=False)\n ```\n ```python\n if __name__ == \"__main__\":\n app.prepare(host='0.0.0.0', port=1337, access_log=False)\n Sanic.serve()\n ```\n\n.. column::\n\n This can be useful if you need to bind your appliction(s) to multiple ports.\n\n.. column::\n\n ```python\n if __name__ == \"__main__\":\n app1.prepare(host='0.0.0.0', port=9990)\n app1.prepare(host='0.0.0.0', port=9991)\n app2.prepare(host='0.0.0.0', port=5555)\n Sanic.serve()\n ```\n\n### Sanic Simple Server\n\n.. column::\n\n Sometimes you just have a directory of static files that need to be served. This especially can be handy for quickly standing up a localhost server. Sanic ships with a Simple Server, where you only need to point it at a directory.\n\n.. column::\n\n ```sh\n sanic ./path/to/dir --simple\n ```\n\n\n.. column::\n\n This could also be paired with auto-reloading.\n\n.. column::\n\n ```sh\n sanic ./path/to/dir --simple --reload --reload-dir=./path/to/dir\n ```\n\n*Added in v21.6*\n\n### Daemon mode\n\n.. new:: New in v25.12\n\n This feature was added in version 25.12\n\n.. column::\n\n Sanic can run as a background daemon process. Use the `-D` or `--daemon` flag to start the server in the background.\n\n.. column::\n\n ```sh\n sanic path.to.server:app --daemon\n sanic path.to.server:app -D\n ```\n\n.. column::\n\n You can manage the daemon with additional commands:\n\n.. column::\n\n ```sh\n sanic path.to.server:app status # Check if running\n sanic path.to.server:app stop # Stop the daemon\n ```\n\n.. column::\n\n Additional options are available for daemon configuration:\n\n.. column::\n\n ```sh\n sanic path.to.server:app -D --pidfile=/var/run/sanic.pid\n sanic path.to.server:app -D --logfile=/var/log/sanic.log\n sanic path.to.server:app -D --user=www-data\n sanic path.to.server:app -D --group=www-data\n ```\n\nLower-level commands are also available to manage processes by PID:\n\n```sh\nsanic kill --pid=\nsanic kill --pidfile=/var/run/sanic.pid\nsanic status --pid=\nsanic status --pidfile=/var/run/sanic.pid\n```\n\n*Added in v25.12*\n\n### HTTP/3\n\nSanic server offers HTTP/3 support using [aioquic](https://github.com/aiortc/aioquic). This **must** be installed to use HTTP/3:\n\n```sh\npip install sanic aioquic\n```\n\n```sh\npip install sanic[http3]\n```\n\nTo start HTTP/3, you must explicitly request it when running your application.\n\n.. column::\n\n ```sh\n sanic path.to.server:app --http=3\n ```\n\n ```sh\n sanic path.to.server:app -3\n ```\n\n.. column::\n\n ```python\n app.run(version=3)\n ```\n\nTo run both an HTTP/3 and HTTP/1.1 server simultaneously, you can use [application multi-serve](../../release-notes/2022/v22.3.md#application-multi-serve) introduced in v22.3. This will automatically add an [Alt-Svc](https://developer.mozilla.org/en-US/docs/Web/HTTP/Headers/Alt-Svc) header to your HTTP/1.1 requests to let the client know that it is also available as HTTP/3.\n\n\n.. column::\n\n ```sh\n sanic path.to.server:app --http=3 --http=1\n ```\n\n ```sh\n sanic path.to.server:app -3 -1\n ```\n\n.. column::\n\n ```python\n app.prepare(version=3)\n app.prepare(version=1)\n Sanic.serve()\n ```\n\nBecause HTTP/3 requires TLS, you cannot start a HTTP/3 server without a TLS certificate. You should [set it up yourself](../how-to/tls.md) or use `mkcert` if in `DEBUG` mode. Currently, automatic TLS setup for HTTP/3 is not compatible with `trustme`. See [development](./development.md) for more details.\n\n*Added in v22.6*\n\n## ASGI\n\nSanic is also ASGI-compliant. This means you can use your preferred ASGI webserver to run Sanic. The three main implementations of ASGI are [Daphne](http://github.com/django/daphne), [Uvicorn](https://www.uvicorn.org/), and [Hypercorn](https://pgjones.gitlab.io/hypercorn/index.html).\n\n\n.. warning:: \n\n Daphne does not support the ASGI `lifespan` protocol, and therefore cannot be used to run Sanic. See [Issue #264](https://github.com/django/daphne/issues/264) for more details.\n\n\n\nFollow their documentation for the proper way to run them, but it should look something like:\n\n```sh\nuvicorn myapp:app\n```\n```sh\nhypercorn myapp:app\n```\n\nA couple things to note when using ASGI:\n\n1. When using the Sanic webserver, websockets will run using the `websockets` package. In ASGI mode, there is no need for this package since websockets are managed in the ASGI server. \n2. The ASGI lifespan protocol , supports only two server events: startup and shutdown. Sanic has four: before startup, after startup, before shutdown, and after shutdown. Therefore, in ASGI mode, the startup and shutdown events will run consecutively and not actually around the server process beginning and ending (since that is now controlled by the ASGI server). Therefore, it is best to use `after_server_start` and `before_server_stop`.\n\n### Trio\n\nSanic has experimental support for running on Trio with:\n\n```sh\nhypercorn -k trio myapp:app\n```\n\n## Gunicorn\n\n[Gunicorn](http://gunicorn.org/) (\"Green Unicorn\") is a WSGI HTTP Server for UNIX based operating systems. It is a pre-fork worker model ported from Ruby’s Unicorn project.\n\nIn order to run Sanic application with Gunicorn, you need to use it with the adapter from [uvicorn](https://www.uvicorn.org/). Make sure uvicorn is installed and run it with `uvicorn.workers.UvicornWorker` for Gunicorn worker-class argument:\n\n```sh\ngunicorn myapp:app --bind 0.0.0.0:1337 --worker-class uvicorn.workers.UvicornWorker\n```\n\nSee the [Gunicorn Docs](http://docs.gunicorn.org/en/latest/settings.html#max-requests) for more information.\n\n\n.. warning:: \n\n It is generally advised to not use `gunicorn` unless you need it. The Sanic Server is primed for running Sanic in production. Weigh your considerations carefully before making this choice. Gunicorn does provide a lot of configuration options, but it is not the best choice for getting Sanic to run at its fastest.\n\n\n\n## Performance considerations\n\n.. column::\n\n When running in production, make sure you turn off `debug`.\n\n.. column::\n\n ```sh\n sanic path.to.server:app\n ```\n\n\n.. column::\n\n Sanic will also perform fastest if you turn off `access_log`.\n\n If you still require access logs, but want to enjoy this performance boost, consider using [Nginx as a proxy](./../deployment/nginx.md), and letting that handle your access logging. It will be much faster than anything Python can handle.\n\n.. column::\n\n ```sh\n sanic path.to.server:app --no-access-logs\n ```\n\n" }, { "path": "guide/content/en/help.md", "content": "---\ntitle: Need some help?\nlayout: main\n---\n\n# Need some help?\n\nAs an active community of developers, we try to support each other. If you need some help, try one of the following:\n\n.. column::\n\n ### Discord 💬\n\n Best place to turn for quick answers and live chat\n\n `#sanic-support` channel on the [Discord server](https://discord.gg/FARQzAEMAA)\n\n.. column::\n\n ### Community Forums 👥\n\n Good for sharing snippets of code and longer support queries\n\n `Questions and Help` category on the [Forums](https://community.sanicframework.org/c/questions-and-help/6)\n\n---\n\nWe also actively monitor the `[sanic]` tag on [Stack Overflow](https://stackoverflow.com/questions/tagged/sanic).\n" }, { "path": "guide/content/en/index.md", "content": "---\ntitle: The lightning-fast asynchronous Python web framework\nlayout: home\nfeatures:\n- title: Simple and lightweight\n details: Intuitive API with smart defaults and no bloat allows you to get straight to work building your app.\n- title: Unopinionated and flexible\n details: Build the way you want to build without letting your tooling constrain you.\n- title: Performant and scalable\n details: Built from the ground up with speed and scalability as a main concern. It is ready to power web applications big and small.\n- title: Production ready\n details: Out of the box, it comes bundled with a web server ready to power your web applications.\n- title: Trusted by millions\n details: Sanic is one of the overall most popular frameworks on PyPI, and the top async enabled framework\n- title: Community driven\n details: The project is maintained and run by the community for the community.\n---\n\n### ⚡ The lightning-fast asynchronous Python web framework\n\n.. attrs::\n :class: columns is-multiline mt-6\n\n .. attrs::\n :class: column is-4\n\n #### Simple and lightweight\n\n Intuitive API with smart defaults and no bloat allows you to get straight to work building your app.\n\n .. attrs::\n :class: column is-4\n\n #### Unopinionated and flexible\n\n Build the way you want to build without letting your tooling constrain you.\n\n .. attrs::\n :class: column is-4\n\n #### Performant and scalable\n\n Built from the ground up with speed and scalability as a main concern. It is ready to power web applications big and small.\n\n .. attrs::\n :class: column is-4\n\n #### Production ready\n\n Out of the box, it comes bundled with a web server ready to power your web applications.\n\n .. attrs::\n :class: column is-4\n\n #### Trusted by millions\n\n Sanic is one of the overall most popular frameworks on PyPI, and the top async enabled framework\n\n .. attrs::\n :class: column is-4\n\n #### Community driven\n\n The project is maintained and run by the community for the community.\n\n\n.. attrs::\n :class: is-size-3 mt-6\n\n **With the features and tools you'd expect.**\n\n.. attrs::\n :class: is-size-3 ml-6\n \n **And some {span:has-text-primary:you wouldn't believe}.**\n\n.. tab:: Production-grade\n \n After installing, Sanic has all the tools you need for a scalable, production-grade server—out of the box!\n\n Including [full TLS support](/en/guide/how-to/tls.md).\n\n ```python\n from sanic import Sanic\n from sanic.response import text\n\n app = Sanic(\"MyHelloWorldApp\")\n\n @app.get(\"/\")\n async def hello_world(request):\n return text(\"Hello, world.\")\n ```\n\n ```sh\n sanic path.to.server:app\n [2023-01-31 12:34:56 +0000] [999996] [INFO] Sanic v22.12.0\n [2023-01-31 12:34:56 +0000] [999996] [INFO] Goin' Fast @ http://127.0.0.1:8000\n [2023-01-31 12:34:56 +0000] [999996] [INFO] mode: production, single worker\n [2023-01-31 12:34:56 +0000] [999996] [INFO] server: sanic, HTTP/1.1\n [2023-01-31 12:34:56 +0000] [999996] [INFO] python: 3.10.9\n [2023-01-31 12:34:56 +0000] [999996] [INFO] platform: SomeOS-9.8.7\n [2023-01-31 12:34:56 +0000] [999996] [INFO] packages: sanic-routing==22.8.0\n [2023-01-31 12:34:56 +0000] [999997] [INFO] Starting worker [999997]\n ```\n\n.. tab:: TLS server\n \n Running Sanic with TLS enabled is as simple as passing it the file paths...\n ```sh\n sanic path.to.server:app --cert=/path/to/bundle.crt --key=/path/to/privkey.pem\n ```\n\n ... or the a directory containing `fullchain.pem` and `privkey.pem`\n\n ```sh\n sanic path.to.server:app --tls=/path/to/certs\n ```\n\n **Even better**, while you are developing, let Sanic handle setting up local TLS certificates so you can access your site over TLS at [https://localhost:8443](https://localhost:8443)\n\n ```sh\n sanic path.to.server:app --dev --auto-tls\n ```\n\n.. tab:: Websockets\n\n Up and running with websockets in no time using the [websockets](https://websockets.readthedocs.io) package.\n ```python\n from sanic import Request, Websocket\n\n @app.websocket(\"/feed\")\n async def feed(request: Request, ws: Websocket):\n async for msg in ws:\n await ws.send(msg)\n ```\n\n.. tab:: Static files\n\n Serving static files is of course intuitive and easy. Just name an endpoint and either a file or directory that should be served.\n\n ```python\n app.static(\"/\", \"/path/to/index.html\")\n app.static(\"/uploads/\", \"/path/to/uploads/\")\n ```\n\n Moreover, serving a directory has two additional features: automatically serving an index, and automatically serving a file browser.\n \n Sanic can automatically serve `index.html` (or any other named file) as an index page in a directory or its subdirectories.\n \n ```python\n app.static(\n \"/uploads/\",\n \"/path/to/uploads/\",\n index=\"index.html\"\n )\n ```\n\n And/or, setup Sanic to display a file browser.\n\n \n ![image](/assets/images/directory-view.png)\n\n ```python\n app.static(\n \"/uploads/\",\n \"/path/to/uploads/\",\n directory_view=True\n )\n ```\n\n.. tab:: Lifecycle\n\n Beginning or ending a route with functionality is as simple as adding a decorator.\n\n ```python\n @app.on_request\n async def add_key(request):\n request.ctx.foo = \"bar\"\n\n @app.on_response\n async def custom_banner(request, response):\n response.headers[\"X-Foo\"] = request.ctx.foo\n ```\n\n Same with server events.\n\n ```python\n @app.before_server_start\n async def setup_db(app):\n app.ctx.db_pool = await db_setup()\n\n @app.after_server_stop\n async def setup_db(app):\n await app.ctx.db_pool.shutdown()\n ```\n\n But, Sanic also allows you to tie into a bunch of built-in events (called signals), or create and dispatch your own.\n\n ```python\n @app.signal(\"http.lifecycle.complete\") # built-in\n async def my_signal_handler(conn_info):\n print(\"Connection has been closed\")\n\n @app.signal(\"something.happened.ohmy\") # custom\n async def my_signal_handler():\n print(\"something happened\")\n\n await app.dispatch(\"something.happened.ohmy\")\n ```\n\n.. tab:: Smart error handling\n\n Raising errors will intuitively result in proper HTTP errors:\n\n ```python\n raise sanic.exceptions.NotFound # Automatically responds with HTTP 404\n ```\n\n Or, make your own:\n\n ```python\n from sanic.exceptions import SanicException\n\n class TeapotError(SanicException):\n status_code = 418\n message = \"Sorry, I cannot brew coffee\"\n\n raise TeapotError\n ```\n\n And, when an error does happen, Sanic's beautiful DEV mode error page will help you drill down to the bug quickly.\n\n ![image](../assets/images/error-div-by-zero.png)\n\n Regardless, Sanic comes with an algorithm that attempts to respond with HTML, JSON, or text-based errors as appropriate. Don't worry, it is super easy to setup and customize your error handling to your exact needs.\n\n.. tab:: App Inspector\n\n Check in on your live, running applications (whether local or remote).\n ```sh\n sanic inspect \n\n ┌─────────────────────────────────────────────────────────────────────────────────────────────────────────────────────┐\n │ Sanic │\n │ Inspecting @ http://localhost:6457 │\n ├───────────────────────┬─────────────────────────────────────────────────────────────────────────────────────────────┤\n │ │ mode: production, single worker │\n │ ▄███ █████ ██ │ server: unknown │\n │ ██ │ python: 3.10.9 │\n │ ▀███████ ███▄ │ platform: SomeOS-9.8.7\n │ ██ │ packages: sanic==22.12.0, sanic-routing==22.8.0, sanic-testing==22.12.0, sanic-ext==22.12.0 │\n │ ████ ████████▀ │ │\n │ │ │\n │ Build Fast. Run Fast. │ │\n └───────────────────────┴─────────────────────────────────────────────────────────────────────────────────────────────┘\n\n Sanic-Main\n pid: 999996\n\n Sanic-Server-0-0\n server: True\n state: ACKED\n pid: 999997\n start_at: 2023-01-31T12:34:56.00000+00:00\n starts: 1\n\n Sanic-Inspector-0\n server: False\n state: STARTED\n pid: 999998\n start_at: 2023-01-31T12:34:56.00000+00:00\n starts: 1\n ```\n\n And, issue commands like `reload`, `shutdown`, `scale`...\n\n ```sh\n sanic inspect scale 4\n ```\n\n ... or even create your own!\n\n ```sh\n sanic inspect migrations\n ```\n\n.. tab:: Extendable\n\n In addition to the tools that Sanic comes with, the officially supported [Sanic Extensions](./plugins/sanic-ext/getting-started.md) provides lots of extra goodies to make development easier.\n\n - **CORS** protection\n - Template rendering with **Jinja**\n - **Dependency injection** into route handlers\n - OpenAPI documentation with **Redoc** and/or **Swagger**\n - Predefined, endpoint-specific response **serializers**\n - Request query arguments and body input **validation**\n - **Auto create** HEAD, OPTIONS, and TRACE endpoints\n - Live **health monitor**\n\n.. tab:: Developer Experience\n\n Sanic is **built for building**.\n\n From the moment it is installed, Sanic includes helpful tools to help the developer get their job done.\n\n - **One server** - Develop locally in DEV mode on the same server that will run your PRODUCTION application\n - **Auto reload** - Reload running applications every time you save a Python file, but also auto-reload **on any arbitrary directory** like HTML template directories\n - **Debugging tools** - Super helpful (and beautiful) [error pages](/en/guide/best-practices/exceptions) that help you traverse the trace stack easily\n - **Auto TLS** - Running a localhost website with `https` can be difficult, [Sanic makes it easy](/en/guide/how-to/tls.md)\n - **Streamlined testing** - Built-in testing capabilities, making it easier for developers to create and run tests, ensuring the quality and reliability of their services\n - **Modern Python** - Thoughtful use of type hints to help the developer IDE experience\n" }, { "path": "guide/content/en/migrate.py", "content": "import re\n\nfrom pathlib import Path\nfrom textwrap import indent\n\nfrom emoji import EMOJI\n\n\nCOLUMN_PATTERN = re.compile(r\"---:1\\s*(.*?)\\s*:--:1\\s*(.*?)\\s*:---\", re.DOTALL)\nPYTHON_HIGHLIGHT_PATTERN = re.compile(r\"```python\\{+.*?\\}\", re.DOTALL)\nBASH_HIGHLIGHT_PATTERN = re.compile(r\"```bash\\{+.*?\\}\", re.DOTALL)\nNOTIFICATION_PATTERN = re.compile(\n r\":::\\s*(\\w+)\\s*(.*?)\\n([\\s\\S]*?):::\", re.MULTILINE\n)\nEMOJI_PATTERN = re.compile(r\":(\\w+):\")\nCURRENT_DIR = Path(__file__).parent\nSOURCE_DIR = (\n CURRENT_DIR.parent.parent.parent.parent / \"sanic-guide\" / \"src\" / \"en\"\n)\n\n\ndef convert_columns(content: str):\n def replacer(match: re.Match):\n left, right = match.groups()\n left = indent(left.strip(), \" \" * 4)\n right = indent(right.strip(), \" \" * 4)\n return f\"\"\"\n.. column::\n\n{left}\n\n.. column::\n\n{right}\n\"\"\"\n\n return COLUMN_PATTERN.sub(replacer, content)\n\n\ndef cleanup_highlights(content: str):\n content = PYTHON_HIGHLIGHT_PATTERN.sub(\"```python\", content)\n content = BASH_HIGHLIGHT_PATTERN.sub(\"```bash\", content)\n return content\n\n\ndef convert_notifications(content: str):\n def replacer(match: re.Match):\n type_, title, body = match.groups()\n body = indent(body.strip(), \" \" * 4)\n return f\"\"\"\n\n.. {type_}:: {title}\n\n{body}\n\n\"\"\"\n\n return NOTIFICATION_PATTERN.sub(replacer, content)\n\n\ndef convert_emoji(content: str):\n def replace(match):\n return EMOJI.get(match.group(1), match.group(0))\n\n return EMOJI_PATTERN.sub(replace, content)\n\n\ndef convert_code_blocks(content: str):\n for src, dest in (\n (\"yml\", \"yaml\"),\n (\"caddy\", \"\"),\n (\"systemd\", \"\"),\n (\"mermaid\", \"\\nmermaid\"),\n ):\n content = content.replace(f\"```{src}\", f\"```{dest}\")\n return content\n\n\ndef cleanup_multibreaks(content: str):\n return content.replace(\"\\n\\n\\n\", \"\\n\\n\")\n\n\ndef convert(content: str):\n content = convert_emoji(content)\n content = convert_columns(content)\n content = cleanup_highlights(content)\n content = convert_code_blocks(content)\n content = convert_notifications(content)\n content = cleanup_multibreaks(content)\n return content\n\n\ndef convert_file(src: Path, dest: Path):\n short_src = src.relative_to(SOURCE_DIR)\n short_dest = dest.relative_to(CURRENT_DIR)\n print(f\"Converting {short_src} -> {short_dest}\")\n content = src.read_text()\n new_content = convert(content)\n dest.parent.mkdir(parents=True, exist_ok=True)\n dest.touch()\n dest.write_text(new_content)\n\n\ndef translate_path(source_dir: Path, source_path: Path, dest_dir: Path):\n rel_path = source_path.relative_to(source_dir)\n dest_path = dest_dir / rel_path\n return dest_path\n\n\ndef main():\n print(f\"Source: {SOURCE_DIR}\")\n\n for path in SOURCE_DIR.glob(\"**/*.md\"):\n if path.name in (\"index.md\", \"README.md\"):\n continue\n dest_path = translate_path(SOURCE_DIR, path, CURRENT_DIR)\n convert_file(path, dest_path)\n\n\nif __name__ == \"__main__\":\n main()\n" }, { "path": "guide/content/en/organization/code-of-conduct.md", "content": "# Contributor Covenant Code of Conduct\n\n## Our Pledge\n\nIn the interest of fostering an open and welcoming environment, we as\ncontributors and maintainers pledge to making participation in our project and\nour community a harassment-free experience for everyone, regardless of age, body\nsize, disability, ethnicity, gender identity and expression, level of experience,\nnationality, personal appearance, race, religion, or sexual identity and\norientation.\n\n## Our Standards\n\nExamples of behavior that contributes to creating a positive environment\ninclude:\n\n* Using welcoming and inclusive language\n* Being respectful of differing viewpoints and experiences\n* Gracefully accepting constructive criticism\n* Focusing on what is best for the community\n* Showing empathy towards other community members\n\nExamples of unacceptable behavior by participants include:\n\n* The use of sexualized language or imagery and unwelcome sexual attention or\nadvances\n* Trolling, insulting/derogatory comments, and personal or political attacks\n* Public or private harassment\n* Publishing others' private information, such as a physical or electronic\n address, without explicit permission\n* Other conduct which could reasonably be considered inappropriate in a\n professional setting\n\n## Our Responsibilities\n\nProject maintainers are responsible for clarifying the standards of acceptable\nbehavior and are expected to take appropriate and fair corrective action in\nresponse to any instances of unacceptable behavior.\n\nProject maintainers have the right and responsibility to remove, edit, or\nreject comments, commits, code, wiki edits, issues, and other contributions\nthat are not aligned to this Code of Conduct, or to ban temporarily or\npermanently any contributor for other behaviors that they deem inappropriate,\nthreatening, offensive, or harmful.\n\n## Scope\n\nThis Code of Conduct applies both within project spaces and in public spaces\nwhen an individual is representing the project or its community. Examples of\nrepresenting a project or community include using an official project e-mail\naddress, posting via an official social media account, or acting as an appointed\nrepresentative at an online or offline event. Representation of a project may be\nfurther defined and clarified by project maintainers.\n\n## Enforcement\n\nInstances of abusive, harassing, or otherwise unacceptable behavior may be\nreported by contacting the project team at adam@sanicframework.org. All\ncomplaints will be reviewed and investigated and will result in a response that\nis deemed necessary and appropriate to the circumstances. The project team is\nobligated to maintain confidentiality with regard to the reporter of an incident.\nFurther details of specific enforcement policies may be posted separately.\n\nProject maintainers who do not follow or enforce the Code of Conduct in good\nfaith may face temporary or permanent repercussions as determined by other\nmembers of the project's leadership.\n\n## Attribution\n\nThis Code of Conduct is adapted from the [Contributor Covenant][homepage], version 1.4,\navailable at [http://contributor-covenant.org/version/1/4][version]\n\n[homepage]: http://contributor-covenant.org\n[version]: http://contributor-covenant.org/version/1/4/\n" }, { "path": "guide/content/en/organization/contributing.md", "content": "# Contributing\n\nThank you for your interest! Sanic is always looking for contributors. If you don't feel comfortable contributing code, adding docstrings to the source files, or helping with the [Sanic User Guide](https://github.com/sanic-org/sanic-guide) by providing documentation or implementation examples would be appreciated!\n\nWe are committed to providing a friendly, safe and welcoming environment for all, regardless of gender, sexual orientation, disability, ethnicity, religion, or similar personal characteristic. Our [code of conduct](https://github.com/sanic-org/sanic/blob/master/CONDUCT.md) sets the standards for behavior.\n\n## Installation\n\nTo develop on Sanic (and mainly to just run the tests) it is highly recommend to install from sources.\n\nSo assume you have already cloned the repo and are in the working directory with a virtual environment already set up, then run:\n\n```sh\npip install -e \".[dev]\"\n```\n\n## Dependency Changes\n\n`Sanic` doesn't use `requirements*.txt` files to manage any kind of dependencies related to it in order to simplify the effort required in managing the dependencies. Please make sure you have read and understood the following section of the document that explains the way `sanic` manages dependencies inside the `setup.py` file.\n\n| Dependency Type | Usage | Installation |\n| ------------------------------- | ------------------------------------------------- | ---------------------------- |\n| requirements | Bare minimum dependencies required for sanic to function | `pip3 install -e .` |\n| tests_require / extras_require['test'] | Dependencies required to run the Unit Tests for `sanic` | `pip3 install -e '.[test]'` |\n| extras_require['dev'] | Additional Development requirements to add contributing | `pip3 install -e '.[dev]'` |\n| extras_require['docs'] | Dependencies required to enable building and enhancing sanic documentation | `pip3 install -e '.[docs]'` |\n\n## Running all tests\n\nTo run the tests for Sanic it is recommended to use tox like so:\n\n```sh\ntox\n```\n\nSee it's that simple!\n\n`tox.ini` contains different environments. Running `tox` without any arguments will\nrun all unittests, perform lint and other checks.\n\n## Run unittests\n\n`tox` environment -> `[testenv]`\n\nTo execute only unittests, run `tox` with environment like so:\n\n```sh\n\ntox -e py37 -v -- tests/test_config.py\n# or\ntox -e py310 -v -- tests/test_config.py\n```\n\n## Run lint checks\n\n`tox` environment -> `[testenv:lint]`\n\nPermform `flake8`\\ , `black` and `isort` checks.\n\n\n```sh\ntox -e lint\n```\n\n## Run type annotation checks\n\n`tox` environment -> `[testenv:type-checking]`\n\nPermform `mypy` checks.\n\n```sh\ntox -e type-checking\n```\n\n## Run other checks\n\n`tox` environment -> `[testenv:check]`\n\nPerform other checks.\n\n```sh\ntox -e check\n```\n\n## Run Static Analysis\n\n`tox` environment -> `[testenv:security]`\n\nPerform static analysis security scan\n\n```sh\ntox -e security\n```\n\n## Run Documentation sanity check\n\n`tox` environment -> `[testenv:docs]`\n\nPerform sanity check on documentation\n\n```sh\ntox -e docs\n```\n## Code Style\n\nTo maintain the code consistency, Sanic uses the following tools:\n\n1. [isort](https://github.com/timothycrosley/isort)\n2. [black](https://github.com/python/black)\n3. [flake8](https://github.com/PyCQA/flake8)\n4. [slotscheck](https://github.com/ariebovenberg/slotscheck)\n\n### isort\n\n`isort` sorts Python imports. It divides imports into three categories sorted each in alphabetical order:\n\n1. built-in\n2. third-party\n3. project-specific\n\n### black\n\n`black` is a Python code formatter.\n\n### flake8\n\n`flake8` is a Python style guide that wraps the following tools into one:\n\n1. PyFlakes\n2. pycodestyle\n3. Ned Batchelder's McCabe script\n\n### slotscheck\n\n`slotscheck` ensures that there are no problems with `__slots__` (e.g., overlaps, or missing slots in base classes).\n\n`isort`, `black`, `flake8`, and `slotscheck` checks are performed during `tox` lint checks.\n\nThe **easiest** way to make your code conform is to run the following before committing:\n\n```bash\nmake pretty\n```\n\nRefer to [tox documentation](https://tox.readthedocs.io/en/latest/index.html) for more details.\n\n## Pull requests\n\nSo the pull request approval rules are pretty simple:\n\n1. All pull requests must pass unit tests.\n2. All pull requests must be reviewed and approved by at least one current member of the Core Developer team.\n3. All pull requests must pass flake8 checks.\n4. All pull requests must match `isort` and `black` requirements.\n5. All pull requests must be **PROPERLY** type annotated, unless exemption is given.\n6. All pull requests must be consistent with the existing code.\n7. If you decide to remove/change anything from any common interface a deprecation message should accompany it in accordance with our [deprecation policy](https://sanicframework.org/en/guide/project/policies.html#deprecation).\n8. If you implement a new feature you should have at least one unit test to accompany it.\n9. An example must be one of the following:\n * Example of how to use Sanic\n * Example of how to use Sanic extensions\n * Example of how to use Sanic and asynchronous library\n\n## Documentation\n\n_Check back. We are reworking our documentation so this will change._\n" }, { "path": "guide/content/en/organization/policies.md", "content": "# Policies\n\n## Versioning\n\nSanic uses [calendar versioning](https://calver.org/), aka \"calver\". To be more specific, the pattern follows:\n\n```\nYY.MM.MICRO\n```\n\nGenerally, versions are referred to in their ``YY.MM`` form. The `MICRO` number indicates an incremental patch version, starting at `0`.\n\n## Reporting a Vulnerability\n\nIf you discover a security vulnerability, we ask that you **do not** create an issue on GitHub. Instead, please [send a message to the core-devs](https://community.sanicframework.org/g/core-devs) on the community forums. Once logged in, you can send a message to the core-devs by clicking the message button.\n\nAlternatively, you can send a private message to Adam Hopkins on Discord. Find him on the [Sanic discord server](https://discord.gg/FARQzAEMAA).\n\nThis will help to not publicize the issue until the team can address it and resolve it.\n\n## Release Schedule\n\nThere are four (4) scheduled releases per year: March, June, September, and December. Therefore, there are four (4) released versions per year: `YY.3`, `YY.6`, `YY.9`, and `YY.12`. \n\nThis release schedule provides:\n\n- a predictable release cadence,\n- relatively short development windows allowing features to be regularly released,\n- controlled [deprecations](#deprecation), and\n- consistent stability with a yearly LTS.\n\nWe also use the yearly release cycle in conjunction with our governance model, covered by the [S.C.O.P.E.](./scope.md)\n\n### Long term support v Interim releases\n\nSanic releases a long term support release (aka \"LTS\") once a year in December. The LTS releases receive bug fixes and security updates for **24 months**. Interim releases throughout the year occur every three months, and are supported until the subsequent release.\n\n| Version | Release | LTS | Supported |\n|---------|------------|---------------|-----------------|\n| 24.12 | 2024-12-31 | until 2026-12 | ✅ |\n| 24.6 | 2024-06-30 | | ⚪ |\n| 23.12 | 2023-12-31 | until 2025-12 | ☑️ |\n| 23.6 | 2023-07-25 | | ⚪ |\n| 23.3 | 2023-03-26 | | ⚪ |\n| 22.12 | 2022-12-27 | | ☑️ |\n| 22.9 | 2022-09-29 | | ⚪ |\n| 22.6 | 2022-06-30 | | ⚪ |\n| 22.3 | 2022-03-31 | | ⚪ |\n| 21.12 | 2021-12-26 | | ⚪ |\n| 21.9 | 2021-09-30 | | ⚪ |\n| 21.6 | 2021-06-27 | | ⚪ |\n| 21.3 | 2021-03-21 | | ⚪ |\n| 20.12 | 2020-12-29 | | ⚪ |\n| 20.9 | 2020-09-30 | | ⚪ |\n| 20.6 | 2020-06-28 | | ⚪ |\n| 20.3 | 2020-05-14 | | ⚪ |\n| 19.12 | 2019-12-27 | | ⚪ |\n| 19.9 | 2019-10-12 | | ⚪ |\n| 19.6 | 2019-06-21 | | ⚪ |\n| 19.3 | 2019-03-23 | | ⚪ |\n| 18.12 | 2018-12-27 | | ⚪ |\n| 0.8.3 | 2018-09-13 | | ⚪ |\n| 0.7.0 | 2017-12-06 | | ⚪ |\n| 0.6.0 | 2017-08-03 | | ⚪ |\n| 0.5.4 | 2017-05-09 | | ⚪ |\n| 0.4.1 | 2017-02-28 | | ⚪ |\n| 0.3.1 | 2017-02-09 | | ⚪ |\n| 0.2.0 | 2017-01-14 | | ⚪ |\n| 0.1.9 | 2016-12-25 | | ⚪ |\n| 0.1.0 | 2016-10-16 | | ⚪ |\n\n☑️ = security fixes \n✅ = full support \n⚪ = no support\n\n## Deprecation\n\nBefore a feature is deprecated, or breaking changes are introduced into the API, it shall be publicized and shall appear with deprecation warnings through two release cycles. No deprecations shall be made in an LTS release.\n\nBreaking changes or feature removal may happen outside of these guidelines when absolutely warranted. These circumstances should be rare. For example, it might happen when no alternative is available to curtail a major security issue.\n" }, { "path": "guide/content/en/organization/scope.md", "content": "\n# Sanic Community Organization Policy E-manual (SCOPE)\n\n.. attrs::\n :class: is-size-7\n\n _December 2019, version 1_\n\n## Goals\n\nTo create a sustainable, community-driven organization around the Sanic projects that promote: (1) stability and predictability, (2) quick iteration and enhancement cycles, (3) engagement from outside contributors, (4) overall reliable software, and (5) a safe, rewarding environment for the community members.\n\n## Overview\n\nThis Policy is the governance model for the Sanic Community Organization (“SCO”). The SCO is a meritocratic, consensus-based community organization responsible for all projects adopted by it. Anyone with an interest in one of the projects can join the community, contribute to the community or projects, and participate in the decision making process. This document describes how that participation takes place and how to set about earning merit within the project community.\n\n## Structure\n\nThe SCO has multiple **projects**. Each project is represented by a single GitHub repository under the Sanic community umbrella. These projects are used by **users**, developed by **contributors**, governed by **core developers**, released by **release managers**, and ultimately overseen by a **steering council**. If this sounds similar to the Python project and PEP 8016 that is because it is intentionally designed that way.\n\n## Roles and responsibilities\n\n### Users\n\nUsers are community members who have a need for the projects. They are the developers and personnel that download and install the packages. Users are the **most important** members of the community and without them the projects would have no purpose. Anyone can be a user and the licenses adopted by the projects shall be appropriate open source licenses.\n\n_The SCO asks its users to participate in the project and community as much as possible._\n\nUser contributions enable the project team to ensure that they are satisfying the needs of those users. Common user contributions include (but are not limited to):\n\n* evangelizing about the project (e.g. a link on a website and word-of-mouth awareness raising)\n* informing developers of strengths and weaknesses from a new user perspective\n* providing moral support (a ‘thank you’ goes a long way)\n* providing financial support (the software is open source, but its developers need to eat)\n\nUsers who continue to engage with the SCO, its projects, and its community will often become more and more involved. Such users may find themselves becoming contributors, as described in the next section.\n\n### Contributors\n\nContributors are community members who contribute in concrete ways to one or more of the projects. Anyone can become a contributor and contributions can take many forms. Contributions and requirements are governed by each project separately by a contribution policy.\n\nThere is **no expectation** of commitment to the project, **no specific skill requirements** and **no selection process**.\n\nIn addition to their actions as users, contributors may also find themselves doing one or more of the following:\n\n* supporting new users (existing users are often the best people to support new users)\n* reporting bugs\n* identifying requirements\n* providing graphics and web design\n* Programming\n* example use cases\n* assisting with project infrastructure\n* writing documentation\n* fixing bugs\n* adding features\n* providing constructive opinions and engaging in community discourse\n\nContributors engage with the projects through GitHub and the Community Forums. They submit changes to the projects itself via pull requests, which will be considered for inclusion in the project by the community at large. The Community Forums are the most appropriate place to ask for help when making that first contribution.\n\nIndeed one of the most important roles of a contributor may be to **simply engage in the community conversation**. Most decisions about the direction of a project are made by consensus. This is discussed in more detail below. In general, however, it is helpful for the health and direction of the projects for the contributors to **speak freely** (within the confines of the code of conduct) and **express their opinions and experiences** to help drive the consensus building.\n\nAs contributors gain experience and familiarity with a project, their profile within, and commitment to, the community will increase. At some stage, they may find themselves being nominated for a core developer team.\n\n### Core Developer\n\nEach project under the SCO umbrella has its own team of core developers. They are the people in charge of that project.\n\n_What is a core developer?_\n\nCore developers are community members who have shown that they are committed to the continued development of the project through ongoing engagement with the community. Being a core developer allows contributors to more easily carry on with their project related activities by giving them direct access to the project’s resources. They can make changes directly to the project repository without having to submit changes via pull requests from a fork.\n\nThis does not mean that a core developer is free to do what they want. In fact, core developers have no more direct authority over the final release of a package than do contributors. While this honor does indicate a valued member of the community who has demonstrated a healthy respect for the project’s aims and objectives, their work continues to be reviewed by the community before acceptance in an official release.\n\n_What can a core developer do on a project?_\n\nEach project might define this role slightly differently. However, the general usage of this designation is that an individual has risen to a level of trust within the community such that they now are given some control. This comes in the form of push rights to non-protected branches, and the ability to have a voice in the approval of pull requests.\n\nThe projects employ various communication mechanisms to ensure that all contributions are reviewed by the community as a whole. This includes tools provided by GitHub, as well as the Community Forums. By the time a contributor is invited to become a core developer, they should be familiar with the various tools and workflows as a user and then as a contributor.\n\n_How to become a core developer?_\n\nAnyone can become a core developer; there are no special requirements, other than to have shown a willingness and ability to positively participate in the project as a team player.\n\nTypically, a potential core developer will need to show that they have an understanding of the project, its objectives and its strategy. They will also have provided valuable contributions to the project over a period of time. However, there is **no technical or other skill** requirement for eligibility.\n\nNew core developers can be **nominated by any existing core developer** at any time. At least twice a year (April and October) there will be a ballot process run by the Steering Council. Voting should be done by secret ballot. Each existing core developer for that project receives a number of votes equivalent to the number of nominees on the ballot. For example, if there are four nominees, then each existing core developer has four votes. The core developer may cast those votes however they choose, but may not vote for a single nominee more than once. A nominee must receive two-thirds approval from the number of cast ballots (not the number of eligible ballots). Once accepted by the core developers, it is the responsibility of the Steering Council to approve and finalize the nomination. The Steering Council does not have the right to determine whether a nominee is meritorious enough to receive the core developer title. However, they do retain the right to override a vote in cases where the health of the community would so require.\n\nOnce the vote has been held, the aggregated voting results are published on the Community Forums. The nominee is entitled to request an explanation of any override against them. A nominee that fails to be admitted as a core developer may be nominated again in the future.\n\nIt is important to recognize that being a core developer is a privilege, not a right. That privilege must be earned and once earned it can be removed by the Steering Council (see next section) in extreme circumstances. However, under normal circumstances the core developer title exists for as long as the individual wishes to continue engaging with the project and community.\n\nA committer who shows an above-average level of contribution to the project, particularly with respect to its strategic direction and long-term health, may be nominated to become a member of the Steering Council, or a Release Manager. This role is described below.\n\n_What are the rights and responsibilities of core developers?_\n\nAs discussed, the majority of decisions to be made are by consensus building. In certain circumstances where an issue has become more contentious, or a major decision needs to be made, the Release Manager or Steering Council may decide (or be required) to implement the RFC process, which is outlined in more detail below.\n\nIt is also incumbent upon core developers to have a voice in the governance of the community. All core developers for all of the projects have the ability to be nominated to be on the Steering Council and vote in their elections.\n\nThis Policy (the “SCOPE”) may only be changed under the authority of two-thirds of active core developers, except that in the first six (6) months after adoption, the core developers reserve the right to make changes under the authority of a simple majority of active core developers.\n\n_What if a core developer becomes inactive?_\n\nIt is hoped that all core developers participate and remain active on a regular basis in their projects. However, it is also understood that such commitments may not be realistic or possible from time to time.\n\nTherefore, the Steering Council has the duty to encourage participation and the responsibility to place core developers into an inactive status if they are no longer willing or capable to participate. The main purpose of this is **not to punish** a person for behavior, but to help the development process to continue for those that do remain active.\n\nTo this end, a core developer that becomes “inactive” shall not have commit rights to a repository, and shall not participate in any votes. To be eligible to vote in an election, a core developer **must have been active** at the time of the previous scheduled project release.\n\nInactive members may ask the Steering Council to reinstate their status at any time, and upon such request the Steering Council shall make the core developer active again.\n\nIndividuals that know they will be unable to maintain their active status for a period are asked to be in communication with the Steering Council and declare themselves inactive if necessary.\n\nAn “active” core developer is an individual that has participated in a meaningful way during the previous six months. Any further definition is within the discretion of the Steering Council.\n\n### Release Manager\n\nCore developers shall have access only to make commits and merges on non-protected branches. The “master” branch and other protected branches are controlled by the release management team for that project. Release managers shall be elected from the core development team by the core development team, and shall serve for a full release cycle.\n\nEach core developer team may decide how many release managers to have for each release cycle. It is highly encouraged that there be at least two release managers for a release cycle to help divide the responsibilities and not force too much effort upon a single person. However, there also should not be so many managers that their efforts are impeded.\n\nThe main responsibilities of the release management team include:\n\n* push the development cycle forward by monitoring and facilitating technical discussions\n* establish a release calendar and perform actions required to release packages\n* approve pull requests to the master branch and other protected branches\n* merge pull requests to the master branch and other protected branches\n\nThe release managers **do not have the authority to veto or withhold a merge** of a pull request that otherwise meets contribution criteria and has been accepted by the community. It is not their responsibility to decide what should be developed, but rather that the decisions of the community are carried out and that the project is being moved forward.\n\nFrom time to time, a decision may need to be made that cannot be achieved through consensus. In that case, the release managers have the authority to call upon the removal of the decision to the RFC process. This should not occur regularly (unless required as discussed below), and its use should be discouraged in favor of the more communal consensus building strategy.\n\nSince not all projects have the same requirements, the specifics governing release managers on a project shall be set forth in an Appendix to this Policy, or in the project’s contribution guidelines.\n\nIf necessary, the Steering Council has the right to remove a release manager that is derelict in their duties, or for other good cause.\n\n### Steering Council\n\nThe Steering Council is the governing body consisting of those individuals identified as the “project owner” and having control of the resources and assets of the SCO. Their ultimate goal is to ensure the smooth operation of the projects by removing impediments, and assisting the members as needed. It is expected that they will be regular voices in the community.\n\n_What can the Steering Council do?_\n\nThe members of the Steering Council **do not individually have any more authority than any other core developer**, and shall not have any additional rights to make decisions, commits, merges, or the like on a project.\n\nHowever, as a body, the Steering Council has the following capacity:\n\n* accept, remand, and reject all RFCs\n* enforce the community code of conduct\n* administer community assets such as repositories, servers, forums, integration services, and the like (or, to delegate such authority to someone else)\n* place core developers into inactive status where appropriate take any other enforcement measures afforded to it in this Policy, including, in extreme cases, removing core developers\n* adopt or remove projects from the community umbrella\n\nIt is highly encouraged that the Steering Council delegate its authority as much as possible, and where appropriate, to other willing community members.\n\nThe Steering Council **does not have the authority** to change this Policy.\n\n_How many members are on the Steering Council?_\n\nFour.\n\nWhile it seems like a committee with four votes may potentially end in a deadlock with no way to break a majority vote, the Steering Council is discouraged from voting as much as possible. Instead, it should try to work by consensus, and requires three consenting votes when it is necessary to vote on a matter.\n\n_How long do members serve on the Steering Council?_\n\nA single term shall be for two calendar years starting in January. Terms shall be staggered so that each year there are two members continuing from the previous year’s council.\n\nTherefore, the inaugural vote shall have two positions available for a two year term, and two positions available for a one year term.\n\nThere are no limits to the number of terms that can be served, and it is possible for an individual to serve consecutive terms.\n\n_Who runs the Steering Council?_\n\nAfter the Steering Council is elected, the group shall collectively decide upon one person to act as the Chair. The Chair does not have any additional rights or authority over any other member of the Steering Council.\n\nThe role of the Chair is merely as a coordinator and facilitator. The Chair is expected to ensure that all governance processes are adhered to. The position is more administrative and clerical, and is expected that the Chair sets agendas and coordinates discussion of the group.\n\n_How are council members elected?_\n\nOnce a year, **all eligible core developers** for each of the projects shall have the right to elect members to the Steering Council.\n\nNominations shall be open from September 1 and shall close on September 30. After that, voting shall begin on October 1 and shall close on October 31. Every core developer active on the date of the June release of the Sanic Framework for that year shall be eligible to receive one vote per vacant seat on the Steering Council. For the sake of clarity, to be eligible to vote, a core developer **does not** need to be a core developer on Sanic Framework, but rather just have been active within their respective project on that date.\n\nThe top recipients of votes shall be declared the winners. If there is any tie, it is highly encouraged that the tied nominees themselves resolve the dispute before a decision is made at random.\n\nIn regards to the inaugural vote of the Steering Council, the top two vote-recipients shall serve for two years, and the next two vote-recipients shall assume the one-year seats.\n\nTo be an eligible candidate for the Steering Council, the individual must have been a core developer in active status on at least one project for the previous twelve months.\n\n_What if there is a vacancy?_\n\nIf a vacancy on the Steering Council exists during a term, then the next highest vote-recipient in the previous election shall be offered to complete the remainder of the term. If one cannot be found this way, the Steering Council may decide the most appropriate course of action to fill the seat (whether by appointment, vote, or other means).\n\nIf a member of the Steering Council becomes inactive, then that individual shall be removed from the Steering Council immediately and the seat shall become vacant.\n\nIn extreme cases, the body of all core developers has the right to bring a vote to remove a member of the Steering Council for cause by a two-thirds majority of all eligible voting core developers.\n\n_How shall the Steering Council conduct its business?_\n\nAs much as possible, the Steering Council shall conduct its business and discussions in the open. Any member of the community should be allowed to enter the conversation with them. However, at times it may be necessary or appropriate for discussions to be held privately. Selecting the proper venue for conversations is part of the administrative duties of the Chair.\n\nWhile the specifics of how to operate are beyond the scope of the Policy, it is encouraged that the Steering Council attempt to meet at least one time per quarter in a “real-time” discussion. This could be achieved via video conferencing, live chatting, or other appropriate means.\n\nSupport\n-------\n\nAll participants in the community are encouraged to provide support for users within the project management infrastructure. This support is provided as a way of growing the community. Those seeking support should recognize that all support activity within the project is voluntary and is therefore provided as and when time allows. A user requiring guaranteed response times or results should therefore seek to purchase a support contract from a community member. However, for those willing to engage with the project on its own terms, and willing to help support other users, the community support channels are ideal.\n\nDecision making process\n-----------------------\n\nDecisions about the future of the projects are made through discussion with all members of the community, from the newest user to the most experienced member. Everyone has a voice.\n\nAll non-sensitive project management discussion takes place on the community forums, or other designated channels. Occasionally, sensitive discussions may occur in private.\n\nIn order to ensure that the project is not bogged down by endless discussion and continual voting, the project operates a policy of **lazy consensus**. This allows the majority of decisions to be made without resorting to a formal vote. For any **major decision** (as defined below), there is a separate Request for Comment (RFC) process.\n\n### Technical decisions\n\nPull requests and technical decisions should generally fall into the following categories.\n\n* **Routine**: Documentation fixes, code changes that are for cleanup or additional testing. No functionality changes.\n* **Minor**: Changes to the code base that either fix a bug, or introduce a trivial feature. No breaking changes.\n* **Major**: Any change to the code base that breaks or deprecates existing API, alters operation in a non-trivial manner, or adds a significant feature.\n\nIt is generally the responsibility of the release managers to make sure that changes to the repositories receive the proper authorization before merge.\n\nThe release managers retain the authority to individually review and accept routine decisions that meet standards for code quality without additional input.\n\n### Lazy consensus\n\nDecision making (whether by the community or Steering Council) typically involves the following steps:\n\n* proposal\n* discussion\n* vote (if consensus is not reached through discussion)\n* decision\n\nAny community member can make a proposal for consideration by the community. In order to initiate a discussion about a new idea, they should post a message on the appropriate channel on the Community forums, or submit a pull request implementing the idea on GitHub. This will prompt a review and, if necessary, a discussion of the idea.\n\nThe goal of this review and discussion is to gain approval for the contribution. Since most people in the project community have a shared vision, there is often little need for discussion in order to reach consensus.\n\nIn general, as long as nobody explicitly opposes a proposal or patch, it is recognized as having the support of the community. This is called lazy consensus; that is, those who have not stated their opinion explicitly have implicitly agreed to the implementation of the proposal.\n\nLazy consensus is a very important concept within the SCO. It is this process that allows a large group of people to efficiently reach consensus, as someone with no objections to a proposal need not spend time stating their position, and others need not spend time reading such messages.\n\nFor lazy consensus to be effective, it is necessary to allow an appropriate amount of time before assuming that there are no objections to the proposal. This is somewhat dependent upon the circumstances, but it is generally assumed that 72 hours is reasonable. This requirement ensures that everyone is given enough time to read, digest and respond to the proposal. This time period is chosen so as to be as inclusive as possible of all participants, regardless of their location and time commitments. The facilitators of discussion (whether it be the Chair or the Release Managers, where applicable) shall be charged with determining the proper length of time for such consensus to be reached.\n\nAs discussed above regarding so-called routine decisions, the release managers have the right to make decisions within a shorter period of time. In such cases, lazy consensus shall be implied.\n\n### Request for Comment (RFC)\n\nThe Steering Council shall be in charge of overseeing the RFC process. It shall be a process that remains open to debate to all members of the community, and shall allow for ample time to consider a proposal and for members to respond and engage in meaningful discussion.\n\nThe final decision is vested with the Steering Council. However, it is strongly discouraged that the Steering Council adopt a decision that is contrary to any consensus that may exist in the community. From time to time this may happen if there is a conflict between consensus and the overall project and community goals.\n\nAn RFC shall be initiated by submission to the Steering Council in the public manner as set forth by the Steering Council. Debate shall continue and be facilitated by the Steering Council in general, and the Chair specifically.\n\nIn circumstances that the Steering Council feels it is appropriate, the RFC process may be waived in favor of lazy consensus.\n" }, { "path": "guide/content/en/plugins/sanic-ext/configuration.md", "content": "---\ntitle: Sanic Extensions - Configuration\n---\n\n# Configuration\n\nSanic Extensions can be configured in all of the same ways that [you can configure Sanic](../../guide/running/configuration.md). That makes configuring Sanic Extensions very easy.\n\n```python\napp = Sanic(\"MyApp\")\napp.config.OAS_URL_PREFIX = \"/apidocs\"\n```\n\nHowever, there are a few more configuration options that should be considered.\n\n## Manual `extend`\n\n.. column:: \n\n Even though Sanic Extensions will automatically attach to your application, you can manually choose `extend`. When you do that, you can pass all of the configuration values as a keyword arguments (lowercase).\n\n.. column:: \n\n ```python\n app = Sanic(\"MyApp\")\n app.extend(oas_url_prefix=\"/apidocs\")\n ```\n\n.. column:: \n\n Or, alternatively they could be passed all at once as a single `dict`.\n\n.. column:: \n\n ```python\n app = Sanic(\"MyApp\")\n app.extend(config={\"oas_url_prefix\": \"/apidocs\"})\n ```\n\n.. column:: \n\n Both of these solutions suffers from the fact that the names of the configuration settings are not discoverable by an IDE. Therefore, there is also a type annotated object that you can use. This should help the development experience.\n\n.. column:: \n\n ```python\n from sanic_ext import Config\n\n app = Sanic(\"MyApp\")\n app.extend(config=Config(oas_url_prefix=\"/apidocs\"))\n ```\n\n## Settings\n\n.. note::\n\n Often, the easiest way to change these for an application (since they likely are not going to change dependent upon an environment), is to set them directly on the `app.config` object.\n\n Simply use the capitalized version of the configuration key as shown here:\n\n ```python\n app = Sanic(\"MyApp\")\n app.config.OAS_URL_PREFIX = \"/apidocs\"\n ```\n\n### `cors`\n\n- **Type**: `bool`\n- **Default**: `True`\n- **Description**: Whether to enable CORS protection\n\n### `cors_allow_headers`\n\n- **Type**: `str`\n- **Default**: `\"*\"`\n- **Description**: Value of the header: `access-control-allow-headers`\n\n### `cors_always_send`\n\n- **Type**: `bool`\n- **Default**: `True`\n- **Description**: Whether to always send the header: `access-control-allow-origin`\n\n### `cors_automatic_options`\n\n- **Type**: `bool`\n- **Default**: `True`\n- **Description**: Whether to automatically generate `OPTIONS` endpoints for routes that do *not* already have one defined\n\n### `cors_expose_headers`\n\n- **Type**: `str`\n- **Default**: `\"\"`\n- **Description**: Value of the header: `access-control-expose-headers`\n\n### `cors_max_age`\n\n- **Type**: `int`\n- **Default**: `5`\n- **Description**: Value of the header: `access-control-max-age`\n\n### `cors_methods`\n\n- **Type**: `str`\n- **Default**: `\"\"`\n- **Description**: Value of the header: `access-control-access-control-allow-methods`\n\n### `cors_origins`\n\n- **Type**: `str`\n- **Default**: `\"\"`\n- **Description**: Value of the header: `access-control-allow-origin`\n\n\n.. warning:: \n \n Be very careful if you place `*` here. Do not do this unless you know what you are doing as it can be a security issue.\n\n\n### `cors_send_wildcard`\n\n- **Type**: `bool`\n- **Default**: `False`\n- **Description**: Whether to send a wildcard origin instead of the incoming request origin\n\n### `cors_supports_credentials`\n\n- **Type**: `bool`\n- **Default**: `False`\n- **Description**: Value of the header: `access-control-allow-credentials`\n\n### `cors_vary_header`\n\n- **Type**: `bool`\n- **Default**: `True`\n- **Description**: Whether to add the `vary` header\n\n### `http_all_methods`\n\n- **Type**: `bool`\n- **Default**: `True`\n- **Description**: Adds the HTTP `CONNECT` and `TRACE` methods as allowable\n\n### `http_auto_head`\n\n- **Type**: `bool`\n- **Default**: `True`\n- **Description**: Automatically adds `HEAD` handlers to any `GET` routes\n\n### `http_auto_options`\n\n- **Type**: `bool`\n- **Default**: `True`\n- **Description**: Automatically adds `OPTIONS` handlers to any routes without\n\n### `http_auto_trace`\n\n- **Type**: `bool`\n- **Default**: `False`\n- **Description**: Automatically adds `TRACE` handlers to any routes without\n\n### `oas`\n\n- **Type**: `bool`\n- **Default**: `True`\n- **Description**: Whether to enable OpenAPI specification generation\n\n### `oas_autodoc`\n\n- **Type**: `bool`\n- **Default**: `True`\n- **Description**: Whether to automatically extract OpenAPI details from the docstring of a route function\n\n### `oas_ignore_head`\n\n- **Type**: `bool`\n- **Default**: `True`\n- **Description**: WHen `True`, it will not add `HEAD` endpoints into the OpenAPI specification\n\n### `oas_ignore_options`\n\n- **Type**: `bool`\n- **Default**: `True`\n- **Description**: WHen `True`, it will not add `OPTIONS` endpoints into the OpenAPI specification\n\n### `oas_path_to_redoc_html`\n\n- **Type**: `Optional[str]`\n- **Default**: `None`\n- **Description**: Path to HTML file to override the existing Redoc HTML\n\n### `oas_path_to_swagger_html`\n\n- **Type**: `Optional[str]`\n- **Default**: `None`\n- **Description**: Path to HTML file to override the existing Swagger HTML\n\n### `oas_ui_default`\n\n- **Type**: `Optional[str]`\n- **Default**: `\"redoc\"`\n- **Description**: Which OAS documentation to serve on the bare `oas_url_prefix` endpoint; when `None` there will be no documentation at that location\n\n### `oas_ui_redoc`\n\n- **Type**: `bool`\n- **Default**: `True`\n- **Description**: Whether to enable the Redoc UI\n\n### `oas_ui_swagger`\n\n- **Type**: `bool`\n- **Default**: `True`\n- **Description**: Whether to enable the Swagger UI\n\n### `oas_ui_swagger_version`\n\n- **Type**: `str`\n- **Default**: `\"4.1.0\"`\n- **Description**: Which Swagger version to use\n\n### `oas_uri_to_config`\n\n- **Type**: `str`\n- **Default**: `\"/swagger-config\"`\n- **Description**: Path to serve the Swagger configuration\n\n### `oas_uri_to_json`\n\n- **Type**: `str`\n- **Default**: `\"/openapi.json\"`\n- **Description**: Path to serve the OpenAPI JSON\n\n### `oas_uri_to_redoc`\n\n- **Type**: `str`\n- **Default**: `\"/redoc\"`\n- **Description**: Path to Redoc\n\n### `oas_uri_to_swagger`\n\n- **Type**: `str`\n- **Default**: `\"/swagger\"`\n- **Description**: Path to Swagger\n\n### `oas_url_prefix`\n\n- **Type**: `str`\n- **Default**: `\"/docs\"`\n- **Description**: URL prefix for the Blueprint that all of the OAS documentation witll attach to\n\n### `swagger_ui_configuration`\n\n- **Type**: `Dict[str, Any]`\n- **Default**: `{\"apisSorter\": \"alpha\", \"operationsSorter\": \"alpha\", \"docExpansion\": \"full\"}`\n- **Description**: The Swagger documentation to be served to the frontend\n\n### `templating_enable_async`\n\n- **Type**: `bool`\n- **Default**: `True`\n- **Description**: Whether to set `enable_async` on the Jinja `Environment`\n\n### `templating_path_to_templates`\n\n- **Type**: `Union[str, os.PathLike, Sequence[Union[str, os.PathLike]]] `\n- **Default**: `templates`\n- **Description**: A single path, or multiple paths to where your template files are located\n\n### `trace_excluded_headers`\n\n- **Type**: `Sequence[str]`\n- **Default**: `(\"authorization\", \"cookie\")`\n- **Description**: Which headers should be suppresed from responses to `TRACE` requests\n" }, { "path": "guide/content/en/plugins/sanic-ext/convenience.md", "content": "---\ntitle: Sanic Extensions - Convenience\n---\n\n# Convenience\n\n## Fixed serializer\n\n.. column::\n\n Often when developing an application, there will be certain routes that always return the same sort of response. When this is the case, you can predefine the return serializer and on the endpoint, and then all that needs to be returned is the content.\n\n.. column::\n\n ```python\n from sanic_ext import serializer\n\n @app.get(\"/\")\n @serializer(text)\n async def hello_world(request, name: str):\n if name.isnumeric():\n return \"hello \" * int(name)\n return f\"Hello, {name}\"\n ```\n\n\n\n.. column::\n\n The `serializer` decorator also can add status codes.\n\n.. column::\n\n ```python\n from sanic_ext import serializer\n\n @app.post(\"/\")\n @serializer(text, status=202)\n async def create_something(request):\n ...\n ```\n\n## Custom serializer\n\n.. column::\n\n Using the `@serializer` decorator, you can also pass your own custom functions as long as they also return a valid type (`HTTPResonse`).\n\n.. column::\n\n ```python\n def message(retval, request, action, status):\n return json(\n {\n \"request_id\": str(request.id),\n \"action\": action,\n \"message\": retval,\n },\n status=status,\n )\n\n @app.post(\"/\")\n @serializer(message)\n async def do_action(request, action: str):\n return \"This is a message\"\n ```\n\n\n.. column::\n\n Now, returning just a string should return a nice serialized output.\n\n.. column::\n\n ```python\n $ curl localhost:8000/eat_cookies -X POST\n {\n \"request_id\": \"ef81c45b-235c-46dd-9dbd-b550f8fa77f9\",\n \"action\": \"eat_cookies\",\n \"message\": \"This is a message\"\n }\n\n ```\n\n\n## Request counter\n\n.. column::\n\n Sanic Extensions comes with a subclass of `Request` that can be setup to automatically keep track of the number of requests processed per worker process. To enable this, you should pass the `CountedRequest` class to your application contructor.\n\n.. column::\n\n ```python\n from sanic_ext import CountedRequest\n\n app = Sanic(..., request_class=CountedRequest)\n ```\n\n\n.. column::\n\n You will now have access to the number of requests served during the lifetime of the worker process.\n\n.. column::\n\n ```python\n @app.get(\"/\")\n async def handler(request: CountedRequest):\n return json({\"count\": request.count})\n ```\n\nIf possible, the request count will also be added to the [worker state](../../guide/running/manager.md#worker-state).\n\n![](https://user-images.githubusercontent.com/166269/190922460-43bd2cfc-f81a-443b-b84f-07b6ce475cbf.png)\n" }, { "path": "guide/content/en/plugins/sanic-ext/custom.md", "content": "---\ntitle: Sanic Extensions - Custom\n---\n\n# Custom extensions\n\nIt is possible to create your own custom extensions.\n\nVersion 22.9 added the `Extend.register` [method](#extension-preregistration). This makes it extremely easy to add custom expensions to an application.\n\n## Anatomy of an extension\n\nAll extensions must subclass `Extension`.\n\n### Required\n\n- `name`: By convention, the name is an all-lowercase string\n- `startup`: A method that runs when the extension is added\n\n### Optional\n\n- `label`: A method that returns additional information about the extension in the MOTD\n- `included`: A method that returns a boolean whether the extension should be enabled or not (could be used for example to check config state)\n\n### Example\n\n```python\nfrom sanic import Request, Sanic, json\nfrom sanic_ext import Extend, Extension\n\napp = Sanic(__name__)\napp.config.MONITOR = True\n\nclass AutoMonitor(Extension):\n name = \"automonitor\"\n\n def startup(self, bootstrap) -> None:\n if self.included():\n self.app.before_server_start(self.ensure_monitor_set)\n self.app.on_request(self.monitor)\n\n @staticmethod\n async def monitor(request: Request):\n if request.route and request.route.ctx.monitor:\n print(\"....\")\n\n @staticmethod\n async def ensure_monitor_set(app: Sanic):\n for route in app.router.routes:\n if not hasattr(route.ctx, \"monitor\"):\n route.ctx.monitor = False\n\n def label(self):\n has_monitor = [\n route\n for route in self.app.router.routes\n if getattr(route.ctx, \"monitor\", None)\n ]\n return f\"{len(has_monitor)} endpoint(s)\"\n\n def included(self):\n return self.app.config.MONITOR\n\nExtend.register(AutoMonitor)\n\n@app.get(\"/\", ctx_monitor=True)\nasync def handler(request: Request):\n return json({\"foo\": \"bar\"})\n```\n\n## Extension preregistration\n\n.. column::\n\n `Extend.register` simplifies the addition of custom extensions.\n\n.. column::\n\n ```python\n from sanic_ext import Extend, Extension\n\n class MyCustomExtension(Extension):\n ...\n\n Extend.register(MyCustomExtension())\n ```\n\n*Added in v22.9*\n" }, { "path": "guide/content/en/plugins/sanic-ext/getting-started.md", "content": "---\ntitle: Sanic Extensions - Getting Started\n---\n\n# Getting Started\n\nSanic Extensions is an *officially supported* plugin developed, and maintained by the SCO. The primary goal of this project is to add additional features to help Web API and Web application development easier.\n\n## Features\n\n- CORS protection\n- Template rendering with Jinja\n- Dependency injection into route handlers\n- OpenAPI documentation with Redoc and/or Swagger\n- Predefined, endpoint-specific response serializers\n- Request query arguments and body input validation\n- Auto create `HEAD`, `OPTIONS`, and `TRACE` endpoints\n\n## Minimum requirements\n\n- **Python**: 3.8+\n- **Sanic**: 21.9+\n\n## Install\n\nThe best method is to just install Sanic Extensions along with Sanic itself:\n\n```bash\npip install sanic[ext]\n```\n\nYou can of course also just install it by itself.\n\n```bash\npip install sanic-ext\n```\n\n## Extend your application\n\nOut of the box, Sanic Extensions will enable a bunch of features for you. \n\n.. column::\n\n To setup Sanic Extensions (v21.12+), you need to do: **nothing**. If it is installed in the environment, it is setup and ready to go.\n\n This code is the Hello, world app in the [Sanic Getting Started page](../../guide/getting-started.md) _without any changes_, but using Sanic Extensions with `sanic-ext` installed in the background.\n\n.. column::\n\n ```python\n from sanic import Sanic\n from sanic.response import text\n\n app = Sanic(\"MyHelloWorldApp\")\n\n @app.get(\"/\")\n async def hello_world(request):\n return text(\"Hello, world.\")\n ```\n\n\n.. column::\n\n **_OLD DEPRECATED SETUP_**\n\n In v21.9, the easiest way to get started is to instantiate it with `Extend`.\n\n If you look back at the Hello, world app in the [Sanic Getting Started page](../../guide/getting-started.md), you will see the only additions here are the two highlighted lines.\n\n.. column::\n\n ```python\n from sanic import Sanic\n from sanic.response import text\n from sanic_ext import Extend\n\n app = Sanic(\"MyHelloWorldApp\")\n Extend(app)\n\n @app.get(\"/\")\n async def hello_world(request):\n return text(\"Hello, world.\")\n ```\n\nRegardless of how it is setup, you should now be able to view the OpenAPI documentation and see some of the functionality in action: [http://localhost:8000/docs](http://localhost:8000/docs).\n" }, { "path": "guide/content/en/plugins/sanic-ext/health-monitor.md", "content": "---\ntitle: Sanic Extensions - Health Monitor\n---\n\n# Health monitor\n\nThe health monitor requires both `sanic>=22.9` and `sanic-ext>=22.9`.\n\nYou can setup Sanic Extensions to monitor the health of your worker processes. This requires that you not be in [single process mode](../../guide/running/manager.md#single-process-mode).\n\n## Setup\n\n.. column::\n\n Out of the box, the health monitor is disabled. You will need to opt-in and enable the endpoint if you would like to use it.\n\n.. column::\n\n ```python\n app.config.HEALTH = True\n app.config.HEALTH_ENDPOINT = True\n ```\n\n## How does it work\n\nThe monitor sets up a new background process that will periodically receive acknowledgements of liveliness from each worker process. If a worker process misses a report too many times, then the monitor will restart that one worker.\n\n## Diagnostics endpoint\n\n.. column::\n\n The health monitor will also enable a diagnostics endpoint that outputs the [worker state](../../guide/running/manager.md#worker-state). By default is id disabled.\n\n .. danger:: \n\n The diagnostics endpoint is not secured. If you are deploying it in a production environment, you should take steps to protect it with a proxy server if you are using one. If not, you may want to consider disabling this feature in production since it will leak details about your server state.\n\n.. column::\n\n ```\n $ curl http://localhost:8000/__health__\n {\n 'Sanic-Main': {'pid': 99997},\n 'Sanic-Server-0-0': {\n 'server': True,\n 'state': 'ACKED',\n 'pid': 9999,\n 'start_at': datetime.datetime(2022, 10, 1, 0, 0, 0, 0, tzinfo=datetime.timezone.utc),\n 'starts': 2,\n 'restart_at': datetime.datetime(2022, 10, 1, 0, 0, 12, 861332, tzinfo=datetime.timezone.utc)\n },\n 'Sanic-Reloader-0': {\n 'server': False,\n 'state': 'STARTED',\n 'pid': 99998,\n 'start_at': datetime.datetime(2022, 10, 1, 0, 0, 0, 0, tzinfo=datetime.timezone.utc),\n 'starts': 1\n }\n }\n ```\n\n\n## Configuration\n\n| Key | Type | Default| Description |\n|--|--|--|--|\n| HEALTH | `bool` | `False` | Whether to enable this extension. |\n| HEALTH_ENDPOINT | `bool` | `False` | Whether to enable the diagnostics endpoint. |\n| HEALTH_MAX_MISSES | `int` | `3` | The number of consecutive misses before a worker process is restarted. |\n| HEALTH_MISSED_THRESHHOLD | `int` | `10` | The number of seconds the monitor checks for worker process health. |\n| HEALTH_MONITOR | `bool` | `True` | Whether to enable the health monitor. |\n| HEALTH_REPORT_INTERVAL | `int` | `5` | The number of seconds between reporting each acknowledgement of liveliness. |\n| HEALTH_URI_TO_INFO | `str` | `\"\"` | The URI path of the diagnostics endpoint. |\n| HEALTH_URL_PREFIX | `str` | `\"/__health__\"` | The URI prefix of the diagnostics blueprint. |\n" }, { "path": "guide/content/en/plugins/sanic-ext/http/cors.md", "content": "---\ntitle: Sanic Extensions - CORS protection\n---\n\n# CORS protection\n\nCross-Origin Resource Sharing (aka CORS) is a *huge* topic by itself. The documentation here cannot go into enough detail about *what* it is. You are highly encouraged to do some research on your own to understand the security problem presented by it, and the theory behind the solutions. [MDN Web Docs](https://developer.mozilla.org/en-US/docs/Web/HTTP/CORS) are a great first step.\n\nIn super brief terms, CORS protection is a framework that browsers use to facilitate how and when a web page can access information from another domain. It is extremely relevant to anyone building a single-page application. Often times your frontend might be on a domain like `https://portal.myapp.com`, but it needs to access the backend from `https://api.myapp.com`.\n\nThe implementation here is heavily inspired by [`sanic-cors`](https://github.com/ashleysommer/sanic-cors), which is in turn based upon [`flask-cors`](https://github.com/corydolphin/flask-cors). It is therefore very likely that you can achieve a near drop-in replacement of `sanic-cors` with `sanic-ext`.\n\n## Basic implementation\n\n.. column::\n\n As shown in the example in the [auto-endpoints example](methods.md#options), Sanic Extensions will automatically enable CORS protection without further action. But, it does not offer too much out of the box.\n\n At a *bare minimum*, it is **highly** recommended that you set `config.CORS_ORIGINS` to the intended origin(s) that will be accessing the application.\n\n.. column::\n\n ```python\n from sanic import Sanic, text\n from sanic_ext import Extend\n\n app = Sanic(__name__)\n app.config.CORS_ORIGINS = \"http://foobar.com,http://bar.com\"\n Extend(app)\n\n @app.get(\"/\")\n async def hello_world(request):\n return text(\"Hello, world.\")\n ```\n\n ```\n $ curl localhost:8000 -X OPTIONS -i\n HTTP/1.1 204 No Content\n allow: GET,HEAD,OPTIONS\n access-control-allow-origin: http://foobar.com\n connection: keep-alive\n ```\n\n## Configuration\n\nThe true power of CORS protection, however, comes into play once you start configuring it. Here is a table of all of the options.\n\n| Key | Type | Default| Description |\n|--|--|--|--|\n| `CORS_ALLOW_HEADERS` | `str` or `List[str]` | `\"*\"` | The list of headers that will appear in `access-control-allow-headers`. |\n| `CORS_ALWAYS_SEND` | `bool` | `True` | When `True`, will always set a value for `access-control-allow-origin`. When `False`, will only set it if there is an `Origin` header. |\n| `CORS_AUTOMATIC_OPTIONS` | `bool` | `True` | When the incoming preflight request is received, whether to automatically set values for `access-control-allow-headers`, `access-control-max-age`, and `access-control-allow-methods` headers. If `False` these values will only be set on routes that are decorated with the `@cors` decorator. |\n| `CORS_EXPOSE_HEADERS` | `str` or `List[str]` | `\"\"` | Specific list of headers to be set in `access-control-expose-headers` header. |\n| `CORS_MAX_AGE` | `str`, `int`, `timedelta` | `0` | The maximum number of seconds the preflight response may be cached using the `access-control-max-age` header. A falsey value will cause the header to not be set. |\n| `CORS_METHODS` | `str` or `List[str]` | `\"\"` | The HTTP methods that the allowed origins can access, as set on the `access-control-allow-methods` header. |\n| `CORS_ORIGINS` | `str`, `List[str]`, `re.Pattern` | `\"*\"` | The origins that are allowed to access the resource, as set on the `access-control-allow-origin` header. |\n| `CORS_SEND_WILDCARD` | `bool` | `False` | If `True`, will send the wildcard `*` origin instead of the `origin` request header. |\n| `CORS_SUPPORTS_CREDENTIALS` | `bool` | `False` | Whether to set the `access-control-allow-credentials` header. |\n| `CORS_VARY_HEADER` | `bool` | `True` | Whether to add `vary` header, when appropriate. |\n\n*For the sake of brevity, where the above says `List[str]` any instance of a `list`, `set`, `frozenset`, or `tuple` will be acceptable. Alternatively, if the value is a `str`, it can be a comma delimited list.*\n\n## Route level overrides\n\n.. column::\n\n It may sometimes be necessary to override app-wide settings for a specific route. To allow for this, you can use the `@sanic_ext.cors()` decorator to set different route-specific values.\n\n The values that can be overridden with this decorator are:\n\n - `origin`\n - `expose_headers`\n - `allow_headers`\n - `allow_methods`\n - `supports_credentials`\n - `max_age`\n\n.. column::\n\n ```python\n from sanic_ext import cors\n\n app.config.CORS_ORIGINS = \"https://foo.com\"\n\n @app.get(\"/\", host=\"bar.com\")\n @cors(origin=\"https://bar.com\")\n async def hello_world(request):\n return text(\"Hello, world.\")\n ```\n\n" }, { "path": "guide/content/en/plugins/sanic-ext/http/methods.md", "content": "---\ntitle: Sanic Extensions - HTTP Methods\n---\n\n# HTTP Methods\n\n## Auto-endpoints\n\nThe default behavior is to automatically generate `HEAD` endpoints for all `GET` routes, and `OPTIONS` endpoints for all\nroutes. Additionally, there is the option to automatically generate `TRACE` endpoints. However, these are not enabled by\ndefault.\n\n### HEAD\n\n.. column::\n\n - **Configuration**: `AUTO_HEAD` (default `True`)\n - **MDN**: [Read more](https://developer.mozilla.org/en-US/docs/Web/HTTP/Methods/HEAD)\n\n A `HEAD` request provides the headers and an otherwise identical response to what a `GET` request would provide.\n However, it does not actually return the body.\n\n.. column::\n\n ```python\n @app.get(\"/\")\n async def hello_world(request):\n return text(\"Hello, world.\")\n ```\n\n Given the above route definition, Sanic Extensions will enable `HEAD` responses, as seen here.\n\n ```\n $ curl localhost:8000 --head\n HTTP/1.1 200 OK\n access-control-allow-origin: *\n content-length: 13\n connection: keep-alive\n content-type: text/plain; charset=utf-8\n ```\n\n### OPTIONS\n\n.. column::\n\n - **Configuration**: `AUTO_OPTIONS` (default `True`)\n - **MDN**: [Read more](https://developer.mozilla.org/en-US/docs/Web/HTTP/Methods/OPTIONS)\n\n `OPTIONS` requests provide the recipient with details about how the client is allowed to communicate with a given\n endpoint.\n\n.. column::\n\n ```python\n @app.get(\"/\")\n async def hello_world(request):\n return text(\"Hello, world.\")\n ```\n\n Given the above route definition, Sanic Extensions will enable `OPTIONS` responses, as seen here.\n\n It is important to note that we also see `access-control-allow-origins` in this example. This is because\n the [CORS protection](cors.md) is enabled by default.\n\n ```\n $ curl localhost:8000 -X OPTIONS -i\n HTTP/1.1 204 No Content\n allow: GET,HEAD,OPTIONS\n access-control-allow-origin: *\n connection: keep-alive\n ```\n\n.. tip::\n \n Even though Sanic Extensions will setup these routes for you automatically, if you decide to manually create an `@app.options` route, it will *not* be overridden.\n\n### TRACE\n\n.. column::\n\n - **Configuration**: `AUTO_TRACE` (default `False`)\n - **MDN**: [Read more](https://developer.mozilla.org/en-US/docs/Web/HTTP/Methods/TRACE)\n\n By default, `TRACE` endpoints will **not** be automatically created. However, Sanic Extensions **will allow** you to\n create them if you wanted. This is something that is not allowed in vanilla Sanic.\n\n.. column::\n\n ```python\n @app.route(\"/\", methods=[\"trace\"])\n async def handler(request):\n ...\n ```\n\n To enable auto-creation of these endpoints, you must first enable them when extending Sanic.\n\n ```python\n from sanic_ext import Extend, Config\n\n app.extend(config=Config(http_auto_trace=True))\n ```\n\n Now, assuming you have some endpoints setup, you can trace them as shown here:\n\n ```\n $ curl localhost:8000 -X TRACE\n TRACE / HTTP/1.1\n Host: localhost:9999\n User-Agent: curl/7.76.1\n Accept: */*\n ```\n\n.. tip:: \n\n Setting up `AUTO_TRACE` can be super helpful, especially when your application is deployed behind a proxy since it will help you determine how the proxy is behaving.\n\n## Additional method support\n\nVanilla Sanic allows you to build endpoints with the following HTTP methods:\n\n- [GET](/en/guide/basics/routing.html#get)\n- [POST](/en/guide/basics/routing.html#post)\n- [PUT](/en/guide/basics/routing.html#put)\n- [HEAD](/en/guide/basics/routing.html#head)\n- [OPTIONS](/en/guide/basics/routing.html#options)\n- [PATCH](/en/guide/basics/routing.html#patch)\n- [DELETE](/en/guide/basics/routing.html#delete)\n\nSee [MDN Web Docs](https://developer.mozilla.org/en-US/docs/Web/HTTP/Methods) for more.\n\n.. column::\n\n There are, however, two more \"standard\" HTTP methods: `TRACE` and `CONNECT`. Sanic Extensions will allow you to build\n endpoints using these methods, which would otherwise not be allowed.\n\n It is worth pointing out that this will *NOT* enable convenience methods: `@app.trace` or `@app.connect`. You need to\n use `@app.route` as shown in the example here.\n\n.. column::\n\n ```python\n @app.route(\"/\", methods=[\"trace\", \"connect\"])\n async def handler(_):\n return empty()\n ```\n\n" }, { "path": "guide/content/en/plugins/sanic-ext/injection.md", "content": "---\ntitle: Sanic Extensions - Dependency Injection\n---\n\n# Dependency Injection\n\nDependency injection is a method to add arguments to a route handler based upon the defined function signature. Specifically, it looks at the **type annotations** of the arguments in the handler. This can be useful in a number of cases like:\n\n- Fetching an object based upon request headers (like the current session user)\n- Recasting certain objects into a specific type\n- Using the request object to prefetch data\n- Auto inject services\n\nThe `Extend` instance has two basic methods on it used for dependency injection: a lower level `add_dependency`, and a higher level `dependency`. \n\n**Lower level**: `app.ext.add_dependency(...)`\n\n- `type: Type,`: some unique class that will be the type of the object\n- `constructor: Optional[Callable[..., Any]],` (OPTIONAL): a function that will return that type\n\n**Higher level**: `app.ext.dependency(...)`\n\n- `obj: Any`: any object that you would like injected\n- `name: Optional[str]`: some name that could alternately be used as a reference\n\nLet's explore some use cases here.\n\n\n.. warning:: \n\n If you used dependency injection prior to v21.12, the lower level API method was called `injection`. It has since been renamed to `add_dependency` and starting in v21.12 `injection` is an alias for `add_dependency`. The `injection` method has been deprecated for removal in v22.6.\n\n\n\n## Basic implementation\n\nThe simplest use case would be simply to recast a value.\n\n.. column::\n\n This could be useful if you have a model that you want to generate based upon the matched path parameters.\n\n.. column::\n\n ```python\n @dataclass\n class IceCream:\n flavor: str\n\n def __str__(self) -> str:\n return f\"{self.flavor.title()} (Yum!)\"\n\n app.ext.add_dependency(IceCream)\n\n @app.get(\"/\")\n async def ice_cream(request, flavor: IceCream):\n return text(f\"You chose: {flavor}\")\n ```\n\n ```\n $ curl localhost:8000/chocolate\n You chose Chocolate (Yum!)\n ```\n\n\n.. column::\n\n This works by passing a keyword argument to the constructor of the `type` argument. The previous example is equivalent to this.\n\n.. column::\n\n ```python\n flavor = IceCream(flavor=\"chocolate\")\n ```\n\n## Additional constructors\n\n.. column::\n\n Sometimes you may need to also pass a constructor. This could be a function, or perhaps even a classmethod that acts as a constructor. In this example, we are creating an injection that will call `Person.create` first.\n\n Also important to note on this example, we are actually injecting **two (2)** objects! It of course does not need to be this way, but we will inject objects based upon the function signature.\n\n.. column::\n\n ```python\n @dataclass\n class PersonID:\n person_id: int\n\n @dataclass\n class Person:\n person_id: PersonID\n name: str\n age: int\n\n @classmethod\n async def create(cls, request: Request, person_id: int):\n return cls(person_id=PersonID(person_id), name=\"noname\", age=111)\n\n\n app.ext.add_dependency(Person, Person.create)\n app.ext.add_dependency(PersonID)\n\n @app.get(\"/person/\")\n async def person_details(\n request: Request, person_id: PersonID, person: Person\n ):\n return text(f\"{person_id}\\n{person}\")\n ```\n\n ```\n $ curl localhost:8000/person/123\n PersonID(person_id=123)\n Person(person_id=PersonID(person_id=123), name='noname', age=111)\n ```\n\nWhen a `constructor` is passed to `ext.add_dependency` (like in this example) that will be called. If not, then the object will be created by calling the `type`. A couple of important things to note about passing a `constructor`:\n\n1. A positional `request: Request` argument is *usually* expected. See the `Person.create` method above as an example using a `request` and [arbitrary constructors](#arbitrary-constructors) for how to use a callable that does not require a `request`.\n1. All matched path parameters are injected as keyword arguments.\n1. Dependencies can be chained and nested. Notice how in the previous example the `Person` dataclass has a `PersonID`? That means that `PersonID` will be called first, and that value is added to the keyword arguments when calling `Person.create`.\n\n## Arbitrary constructors\n\n.. column::\n\n Sometimes you may want to construct your injectable _without_ the `Request` object. This is useful if you have arbitrary classes or functions that create your objects. If the callable does have any required arguments, then they should themselves be injectable objects.\n\n This is very useful if you have services or other types of objects that should only exist for the lifetime of a single request. For example, you might use this pattern to pull a single connection from your database pool.\n\n.. column::\n\n ```python\n class Alpha:\n ...\n\n class Beta:\n def __init__(self, alpha: Alpha) -> None:\n self.alpha = alpha\n\n app.ext.add_dependency(Alpha)\n app.ext.add_dependency(Beta)\n\n @app.get(\"/beta\")\n async def handler(request: Request, beta: Beta):\n assert isinstance(beta.alpha, Alpha)\n ```\n\n*Added in v22.9*\n\n## Objects from the `Request`\n\n.. column::\n\n Sometimes you may want to extract details from the request and preprocess them. You could, for example, cast the request JSON to a Python object, and then add some additional logic based upon DB queries.\n\n .. warning:: \n\n If you plan to use this method, you should note that the injection actually happens *before* Sanic has had a chance to read the request body. The headers should already have been consumed. So, if you do want access to the body, you will need to manually consume as seen in this example.\n\n ```python\n await request.receive_body()\n ```\n\n\n This could be used in cases where you otherwise might:\n\n - use middleware to preprocess and add something to the `request.ctx`\n - use decorators to preprocess and inject arguments into the request handler\n\n In this example, we are using the `Request` object in the `compile_profile` constructor to run a fake DB query to generate and return a `UserProfile` object.\n\n.. column::\n\n ```python\n @dataclass\n class User:\n name: str\n\n @dataclass\n class UserProfile:\n user: User\n age: int = field(default=0)\n email: str = field(default=\"\")\n\n def __json__(self):\n return ujson.dumps(\n {\n \"name\": self.user.name,\n \"age\": self.age,\n \"email\": self.email,\n }\n )\n\n async def fake_request_to_db(body):\n today = date.today()\n email = f'{body[\"name\"]}@something.com'.lower()\n difference = today - date.fromisoformat(body[\"birthday\"])\n age = int(difference.days / 365)\n return UserProfile(\n User(body[\"name\"]),\n age=age,\n email=email,\n )\n\n async def compile_profile(request: Request):\n await request.receive_body()\n profile = await fake_request_to_db(request.json)\n return profile\n\n app.ext.add_dependency(UserProfile, compile_profile)\n\n @app.patch(\"/profile\")\n async def update_profile(request, profile: UserProfile):\n return json(profile)\n ```\n\n ```\n $ curl localhost:8000/profile -X PATCH -d '{\"name\": \"Alice\", \"birthday\": \"2000-01-01\"}'\n {\n \"name\":\"Alice\",\n \"age\":21,\n \"email\":\"alice@something.com\"\n }\n ```\n\n## Injecting services\n\nIt is a common pattern to create things like database connection pools and store them on the `app.ctx` object. This makes them available throughout your application, which is certainly a convenience. One downside, however, is that you no longer have a typed object to work with. You can use dependency injections to fix this. First we will show the concept using the lower level `add_dependency` like we have been using in the previous examples. But, there is a better way using the higher level `dependency` method.\n\n### The lower level API using `add_dependency`\n\n.. column::\n\n\n This works very similar to the [last example](#objects-from-the-request) where the goal is the extract something from the `Request` object. In this example, a database object was created on the `app.ctx` instance, and is being returned in the dependency injection constructor.\n\n.. column::\n\n ```python\n class FakeConnection:\n async def execute(self, query: str, **arguments):\n return \"result\"\n\n @app.before_server_start\n async def setup_db(app, _):\n app.ctx.db_conn = FakeConnection()\n app.ext.add_dependency(FakeConnection, get_db)\n\n def get_db(request: Request):\n return request.app.ctx.db_conn\n\n\n\n @app.get(\"/\")\n async def handler(request, conn: FakeConnection):\n response = await conn.execute(\"...\")\n return text(response)\n ```\n ```\n $ curl localhost:8000/\n result\n ```\n\n### The higher level API using `dependency`\n\n.. column::\n\n Since we have an actual *object* that is available when adding the dependency injection, we can use the higher level `dependency` method. This will make the pattern much easier to write.\n\n This method should always be used when you want to inject something that exists throughout the lifetime of the application instance and is not request specific. It is very useful for services, third party clients, and connection pools since they are not request specific.\n\n.. column::\n\n ```python\n class FakeConnection:\n async def execute(self, query: str, **arguments):\n return \"result\"\n\n @app.before_server_start\n async def setup_db(app, _):\n db_conn = FakeConnection()\n app.ext.dependency(db_conn)\n\n @app.get(\"/\")\n async def handler(request, conn: FakeConnection):\n response = await conn.execute(\"...\")\n return text(response)\n ```\n ```\n $ curl localhost:8000/\n result\n ```\n\n## Generic types\n\nBe carefule when using a [generic type](https://docs.python.org/3/library/typing.html#typing.Generic). The way that Sanic's dependency injection works is by matching the entire type definition. Therefore, `Foo` is not the same as `Foo[str]`. This can be particularly tricky when trying to use the [higher-level `dependency` method](#the-higher-level-api-using-dependency) since the type is inferred.\n\n.. column::\n\n For example, this will **NOT** work as expected since there is no definition for `Test[str]`.\n\n.. column::\n\n ```python\n import typing\n from sanic import Sanic, text\n\n T = typing.TypeVar(\"T\")\n\n class Test(typing.Generic[T]):\n test: T\n\n app = Sanic(\"testapp\")\n app.ext.dependency(Test())\n\n @app.get(\"/\")\n def test(request, test: Test[str]):\n ...\n ```\n\n\n.. column::\n\n To get this example to work, you will need to add an explicit definition for the type you intend to be injected.\n\n.. column::\n\n ```python\n import typing\n from sanic import Sanic, text\n\n T = typing.TypeVar(\"T\")\n\n class Test(typing.Generic[T]):\n test: T\n\n app = Sanic(\"testapp\")\n _singleton = Test()\n app.ext.add_dependency(Test[str], lambda: _singleton)\n\n @app.get(\"/\")\n def test(request, test: Test[str]):\n ...\n ```\n\n## Configuration\n\n.. column::\n\n By default, dependencies will be injected after the `http.routing.after` [signal](../../guide/advanced/signals.md#built-in-signals). Starting in v22.9, you can change this to the `http.handler.before` signal.\n\n.. column::\n\n ```python\n app.config.INJECTION_SIGNAL = \"http.handler.before\"\n ```\n\n*Added in v22.9*\n" }, { "path": "guide/content/en/plugins/sanic-ext/logger.md", "content": "---\ntitle: Sanic Extensions - Background logger\n---\n\n# Background logger\n\nThe background logger requires both `sanic>=22.9` and `sanic-ext>=22.9`.\n\nYou can setup Sanic Extensions to log all of your messages from a background process. This requires that you not be in [single process mode](../../guide/running/manager.md#single-process-mode).\n\nLogging can sometimes be an expensive operation. By pushing all logging off to a background process, you can potentially gain some performance benefits.\n\n## Setup\n\n.. column::\n\n Out of the box, the background logger is disabled. You will need to opt-in if you would like to use it.\n\n.. column::\n\n ```python\n app.config.LOGGING = True\n ```\n\n## How does it work\n\nWhen enabled, the extension will create a `multiprocessing.Queue`. It will remove all handlers on the [default Sanic loggers](../../guide/best-practices/logging.md) and replace them with a [`QueueHandler`](https://docs.python.org/3/library/logging.handlers.html#queuehandler). When a message is logged, it will be pushed into the queue by the handler, and read by the background process to the log handlers that were originally in place. This means you can still configure logging as normal and it should \"just work.\"\n\n## Configuration\n\n| Key | Type | Default| Description |\n|--|--|--|--|\n| LOGGING | `bool` | `False` | Whether to enable this extension. |\n| LOGGING_QUEUE_MAX_SIZE | `int` | `4096` | The max size of the queue before messages are rejected. |\n" }, { "path": "guide/content/en/plugins/sanic-ext/openapi/advanced.md", "content": "---\ntitle: Sanic Extensions - Advanced OAS\n---\n\n# Advanced\n\n_Documentation in progress_\n\n## CBV\n\n## Blueprints\n\n## Components\n" }, { "path": "guide/content/en/plugins/sanic-ext/openapi/autodoc.md", "content": "---\ntitle: Sanic Extensions - Auto-documentation\n---\n\n# Auto-documentation\n\nTo make documenting endpoints easier, Sanic Extensions will use a function's docstring to populate your documentation. \n\n## Summary and description\n\n.. column::\n\n A function's docstring will be used to create the summary and description. As you can see from this example here, the docstring has been parsed to use the first line as the summary, and the remainder of the string as the description.\n\n.. column::\n\n ```python\n @app.get(\"/foo\")\n async def handler(request, something: str):\n \"\"\"This is a simple foo handler\n\n It is helpful to know that you could also use **markdown** inside your\n docstrings.\n\n - one\n - two\n - three\"\"\"\n return text(\">>>\")\n ```\n ```json\n \"paths\": {\n \"/foo\": {\n \"get\": {\n \"summary\": \"This is a simple foo handler\",\n \"description\": \"It is helpful to know that you could also use **markdown** inside your
docstrings.

- one
- two
- three\",\n \"responses\": {\n \"default\": {\n \"description\": \"OK\"\n }\n },\n \"operationId\": \"get_handler\"\n }\n }\n }\n ```\n\n## Operation level YAML\n\n.. column::\n\n You can expand upon this by adding valid OpenAPI YAML to the docstring. Simply add a line that contains `openapi:`, followed by your YAML. \n\n The `---` shown in the example is *not* necessary. It is just there to help visually identify the YAML as a distinct section of the docstring.\n\n.. column::\n\n ```python\n @app.get(\"/foo\")\n async def handler(request, something: str):\n \"\"\"This is a simple foo handler\n\n Now we will add some more details\n\n openapi:\n ---\n operationId: fooDots\n tags:\n - one\n - two\n parameters:\n - name: limit\n in: query\n description: How many items to return at one time (max 100)\n required: false\n schema:\n type: integer\n format: int32\n responses:\n '200':\n description: Just some dots\n \"\"\"\n return text(\"...\")\n ```\n ```json\n \"paths\": {\n \"/foo\": {\n \"get\": {\n \"operationId\": \"fooDots\",\n \"summary\": \"This is a simple foo handler\",\n \"description\": \"Now we will add some more details\",\n \"tags\": [\n \"one\",\n \"two\"\n ],\n \"parameters\": [\n {\n \"name\": \"limit\",\n \"in\": \"query\",\n \"description\": \"How many items to return at one time (max 100)\",\n \"required\": false,\n \"schema\": {\n \"type\": \"integer\",\n \"format\": \"int32\"\n }\n }\n ],\n \"responses\": {\n \"200\": {\n \"description\": \"Just some dots\"\n }\n }\n }\n }\n }\n ```\n\n\n\n.. note:: \n\n When both YAML documentation and decorators are used, it is the content from the decorators that will take priority when generating the documentation.\n\n\n\n## Excluding docstrings\n\n.. column::\n\n Sometimes a function may contain a docstring that is not meant to be consumed inside the documentation.\n\n **Option 1**: Globally turn off auto-documentation `app.config.OAS_AUTODOC = False`\n\n **Option 2**: Disable it for the single handler with the `@openapi.no_autodoc` decorator\n\n.. column::\n\n ```python\n @app.get(\"/foo\")\n @openapi.no_autodoc\n async def handler(request, something: str):\n \"\"\"This is a docstring about internal info only. Do not parse it.\n \"\"\"\n return text(\"...\")\n ```\n\n" }, { "path": "guide/content/en/plugins/sanic-ext/openapi/basics.md", "content": "---\ntitle: Sanic Extensions - Basic OAS\n---\n\n# Basics\n\n\n.. note::\n\n The OpenAPI implementation in Sanic Extensions is based upon the OAS3 implementation from [`sanic-openapi`](https://github.com/sanic-org/sanic-openapi). In fact, Sanic Extensions is in a large way the successor to that project, which entered maintenance mode upon the release of Sanic Extensions. If you were previously using OAS3 with `sanic-openapi` you should have an easy path to upgrading to Sanic Extensions. Unfortunately, this project does *NOT* support the OAS2 specification.\n\n\n\n.. column::\n\n Out of the box, Sanic Extensions provides automatically generated API documentation using the [v3.0 OpenAPI specification](https://swagger.io/specification/). There is nothing special that you need to do\n\n.. column::\n\n ```python\n from sanic import Sanic\n\n app = Sanic(\"MyApp\")\n\n # Add all of your views\n ```\n\nAfter doing this, you will now have beautiful documentation already generated for you based upon your existing application:\n\n- [http://localhost:8000/docs](http://localhost:8000/docs)\n- [http://localhost:8000/docs/redoc](http://localhost:8000/docs/redoc)\n- [http://localhost:8000/docs/swagger](http://localhost:8000/docs/swagger)\n\nCheckout the [section on configuration](../configuration.md) to learn about changing the routes for the docs. You can also turn off one of the two UIs, and customize which UI will be available on the `/docs` route.\n\n.. column::\n\n Using [Redoc](https://github.com/Redocly/redoc)\n\n ![Redoc](/assets/images/sanic-ext-redoc.png)\n\n.. column::\n\n or [Swagger UI](https://github.com/swagger-api/swagger-ui)\n\n ![Swagger UI](/assets/images/sanic-ext-swagger.png)\n\n## Changing specification metadata\n\n.. column::\n\n If you want to change any of the metada, you should use the `describe` method.\n\n In this example `dedent` is being used with the `description` argument to make multi-line strings a little cleaner. This is not necessary, you can pass any string value here.\n\n.. column::\n\n ```python\n from textwrap import dedent\n\n app.ext.openapi.describe(\n \"Testing API\",\n version=\"1.2.3\",\n description=dedent(\n \"\"\"\n # Info\n This is a description. It is a good place to add some _extra_ doccumentation.\n\n **MARKDOWN** is supported.\n \"\"\"\n ),\n )\n ```\n\n" }, { "path": "guide/content/en/plugins/sanic-ext/openapi/decorators.md", "content": "---\ntitle: Sanic Extensions - OAS Decorators\n---\n\n# Decorators\n\nThe primary mechanism for adding content to your schema is by decorating your endpoints. If you have\nused `sanic-openapi` in the past, this should be familiar to you. The decorators and their arguments match closely\nthe [OAS v3.0 specification](https://swagger.io/specification/).\n\n.. column::\n\n All of the examples show will wrap around a route definition. When you are creating these, you should make sure that\n your Sanic route decorator (`@app.route`, `@app.get`, etc) is the outermost decorator. That is to say that you should\n put that first and then one or more of the below decorators after.\n\n.. column::\n\n ```python\n from sanic_ext import openapi\n\n @app.get(\"/path/to/\")\n @openapi.summary(\"This is a summary\")\n @openapi.description(\"This is a description\")\n async def handler(request, something: str):\n ...\n ```\n\n\n.. column::\n\n You will also see a lot of the below examples reference a model object. For the sake of simplicity, the examples will\n use `UserProfile` that will look like this. The point is that it can be any well-typed class. You could easily imagine\n this being a `dataclass` or some other kind of model object.\n\n.. column::\n\n ```python\n class UserProfile:\n name: str\n age: int\n email: str\n ```\n\n## Definition decorator\n\n### `@openapi.definition`\n\nThe `@openapi.definition` decorator allows you to define all parts of an operations on a path at once. It is an omnibums\ndecorator in that it has the same capabilities to create operation definitions as the rest of the decorators. Using\nmultiple field-specific decorators or a single decorator is a style choice for you the developer.\n\nThe fields are purposely permissive in accepting multiple types to make it easiest for you to define your operation.\n\n**Arguments**\n\n| Field | Type |\n| ------------- | --------------------------------------------------------------------------|\n| `body` | **dict, RequestBody, *YourModel*** |\n| `deprecated` | **bool** |\n| `description` | **str** |\n| `document` | **str, ExternalDocumentation** | \n| `exclude` | **bool** |\n| `operation` | **str** |\n| `parameter` | **str, dict, Parameter, [str], [dict], [Parameter]** |\n| `response` | **dict, Response, *YourModel*, [dict], [Response]** |\n| `summary` | **str** |\n| `tag` | **str, Tag, [str], [Tag]** |\n| `secured` | **Dict[str, Any]** |\n\n**Examples**\n\n.. column::\n\n ```python\n @openapi.definition(\n body=RequestBody(UserProfile, required=True),\n summary=\"User profile update\",\n tag=\"one\",\n response=[Success, Response(Failure, status=400)],\n )\n ```\n\n.. column::\n\n\n\n*See below examples for more examples. Any of the values for the below decorators can be used in the corresponding\nkeyword argument.*\n\n## Field-specific decorators\n\nAll the following decorators are based on `@openapi`\n\n### body\n\n**Arguments**\n\n| Field | Type |\n| ----------- | ---------------------------------- |\n| **content** | ***YourModel*, dict, RequestBody** |\n\n**Examples**\n\n.. column::\n\n ```python\n @openapi.body(UserProfile)\n ```\n\n ```python\n @openapi.body({\"application/json\": UserProfile})\n ```\n\n ```python\n @openapi.body(RequestBody({\"application/json\": UserProfile}))\n ```\n\n.. column::\n\n ```python\n @openapi.body({\"content\": UserProfile})\n ```\n\n ```python\n @openapi.body(RequestBody(UserProfile))\n ```\n\n ```python\n @openapi.body({\"application/json\": {\"description\": ...}})\n ```\n\n### deprecated\n\n**Arguments**\n\n*None*\n\n**Examples**\n\n.. column::\n\n ```python\n @openapi.deprecated()\n ```\n\n.. column::\n\n ```python\n @openapi.deprecated\n ```\n\n### description\n\n**Arguments**\n\n| Field | Type |\n| ------ | ------- |\n| `text` | **str** |\n\n**Examples**\n\n.. column::\n\n ```python\n @openapi.description(\n \"\"\"This is a **description**.\n\n ## You can use `markdown`\n\n - And\n - make\n - lists.\n \"\"\"\n )\n ```\n\n.. column::\n\n\n### document\n\n**Arguments**\n\n| Field | Type |\n| ------------- | ------- |\n| `url` | **str** |\n| `description` | **str** |\n\n**Examples**\n\n.. column::\n\n ```python\n @openapi.document(\"http://example.com/docs\")\n ```\n\n.. column::\n\n ```python\n @openapi.document(ExternalDocumentation(\"http://example.com/more\"))\n ```\n\n### exclude\n\nCan be used on route definitions like all of the other decorators, or can be called on a Blueprint\n\n**Arguments**\n\n| Field | Type | Default |\n| ------ | ------------- | -------- |\n| `flag` | **bool** | **True** |\n| `bp` | **Blueprint** | |\n\n**Examples**\n\n.. column::\n\n ```python\n @openapi.exclude()\n ```\n\n.. column::\n\n ```python\n openapi.exclude(bp=some_blueprint)\n ```\n\n### operation\n\nSets the operation ID.\n\n**Arguments**\n\n| Field | Type |\n| ------ | ------- |\n| `name` | **str** |\n\n**Examples**\n\n.. column::\n\n ```python\n @openapi.operation(\"doNothing\")\n ```\n\n.. column::\n\n\n\n\n**Arguments**\n\n| Field | Type | Default |\n| ---------- | ----------------------------------------- | ----------- |\n| `name` | **str** | |\n| `schema` | ***type*** | **str** |\n| `location` | **\"query\", \"header\", \"path\" or \"cookie\"** | **\"query\"** |\n\n**Examples**\n\n.. column::\n\n ```python\n @openapi.parameter(\"thing\")\n ```\n\n ```python\n @openapi.parameter(parameter=Parameter(\"foobar\", deprecated=True))\n ```\n\n.. column::\n\n ```python\n @openapi.parameter(\"Authorization\", str, \"header\")\n ```\n\n ```python\n @openapi.parameter(\"thing\", required=True, allowEmptyValue=False)\n ```\n\n### response\n\n**Arguments**\n\nIf using a `Response` object, you should not pass any other arguments.\n\n| Field | Type |\n| ------------- | ----------------------------- |\n| `status` | **int** |\n| `content` | ***type*, *YourModel*, dict** |\n| `description` | **str** |\n| `response` | **Response** |\n\n**Examples**\n\n.. column::\n\n ```python\n @openapi.response(200, str, \"This is endpoint returns a string\")\n ```\n\n ```python\n @openapi.response(200, {\"text/plain\": str}, \"...\")\n ```\n\n ```python\n @openapi.response(response=Response(UserProfile, description=\"...\"))\n ```\n\n ```python\n @openapi.response(\n response=Response(\n {\n \"application/json\": UserProfile,\n },\n description=\"...\",\n status=201,\n )\n )\n ```\n\n.. column::\n\n ```python\n @openapi.response(200, UserProfile, \"...\")\n ```\n\n ```python\n @openapi.response(\n 200,\n {\n \"application/json\": UserProfile,\n },\n \"Description...\",\n )\n ```\n\n### summary\n\n**Arguments**\n\n| Field | Type |\n| ------ | ------- |\n| `text` | **str** |\n\n**Examples**\n\n.. column::\n\n ```python\n @openapi.summary(\"This is an endpoint\")\n ```\n\n.. column::\n\n\n### tag\n\n**Arguments**\n\n| Field | Type |\n| ------- | ------------ |\n| `*args` | **str, Tag** |\n\n**Examples**\n\n.. column::\n\n ```python\n @openapi.tag(\"foo\")\n ```\n\n.. column::\n\n ```python\n @openapi.tag(\"foo\", Tag(\"bar\"))\n ```\n\n\n### secured\n\n**Arguments**\n\n| Field | Type |\n| ----------------- | ----------------------- |\n| `*args, **kwargs` | **str, Dict[str, Any]** |\n\n**Examples**\n\n.. column::\n\n ```python\n @openapi.secured()\n ```\n\n.. column::\n\n\n\n.. column::\n\n ```python\n @openapi.secured(\"foo\")\n ```\n\n.. column::\n\n ```python\n @openapi.secured(\"token1\", \"token2\")\n ```\n\n\n.. column::\n\n ```python\n @openapi.secured({\"my_api_key\": []})\n ```\n\n.. column::\n\n ```python\n @openapi.secured(my_api_key=[])\n ```\n\nDo not forget to use `add_security_scheme`. See [security](./security.md) for more details.\n``\n\n## Integration with Pydantic\n\nPydantic models have the ability to [generate OpenAPI schema](https://pydantic-docs.helpmanual.io/usage/schema/). \n\n.. column::\n\n To take advantage of Pydantic model schema generation, pass the output in place of the schema.\n\n.. column::\n\n ```python\n from sanic import Sanic, json\n from sanic_ext import validate, openapi\n from pydantic import BaseModel, Field\n\n @openapi.component()\n class Item(BaseModel):\n name: str\n description: str = None\n price: float\n tax: float = None\n\n class ItemList(BaseModel):\n items: List[Item]\n\n app = Sanic(\"test\")\n\n @app.get(\"/\")\n @openapi.definition(\n body={\n \"application/json\": ItemList.model_json_schema(\n ref_template=\"#/components/schemas/{model}\"\n )\n },\n )\n async def get(request):\n return json({})\n ```\n\n.. note::\n\n It is important to set that `ref_template`. By default Pydantic will select a template that is not standard OAS. This will cause the schema to not be found when generating the final document.\n\n*Added in v22.9*\n" }, { "path": "guide/content/en/plugins/sanic-ext/openapi/security.md", "content": "---\ntitle: Sanic Extensions - OAS Security Schemes\n---\n\n# Security Schemes\n\nTo document authentication schemes, there are two steps.\n\n_Security is only available starting in v21.12.2_\n\n## Document the scheme\n\n.. column::\n\n The first thing that you need to do is define one or more security schemes. The basic pattern will be to define it as:\n\n ```python\n add_security_scheme(\"\", \"\")\n ```\n\n The `type` should correspond to one of the allowed security schemes: `\"apiKey\"`, `\"http\"`, `\"oauth2\"`, `\"openIdConnect\"`. You can then pass appropriate keyword arguments as allowed by the specification.\n\n You should consult the [OpenAPI Specification](https://swagger.io/specification/) for details on what values are appropriate.\n\n.. column::\n\n ```python\n app.ext.openapi.add_security_scheme(\"api_key\", \"apiKey\")\n app.ext.openapi.add_security_scheme(\n \"token\",\n \"http\",\n scheme=\"bearer\",\n bearer_format=\"JWT\",\n )\n app.ext.openapi.add_security_scheme(\"token2\", \"http\")\n app.ext.openapi.add_security_scheme(\n \"oldschool\",\n \"http\",\n scheme=\"basic\",\n )\n app.ext.openapi.add_security_scheme(\n \"oa2\",\n \"oauth2\",\n flows={\n \"implicit\": {\n \"authorizationUrl\": \"http://example.com/auth\",\n \"scopes\": {\n \"on:two\": \"something\",\n \"three:four\": \"something else\",\n \"threefour\": \"something else...\",\n },\n }\n },\n )\n ```\n\n## Document the endpoints\n\n.. column::\n\n There are two options, document _all_ endpoints.\n\n.. column::\n\n ```python\n app.ext.openapi.secured()\n app.ext.openapi.secured(\"token\")\n ```\n\n\n.. column::\n\n Or, document only specific routes.\n\n.. column::\n\n ```python\n @app.route(\"/one\")\n async def handler1(request):\n \"\"\"\n openapi:\n ---\n security:\n - foo: []\n \"\"\"\n\n @app.route(\"/two\")\n @openapi.secured(\"foo\")\n @openapi.secured({\"bar\": []})\n @openapi.secured(baz=[])\n async def handler2(request):\n ...\n\n @app.route(\"/three\")\n @openapi.definition(secured=\"foo\")\n @openapi.definition(secured={\"bar\": []})\n async def handler3(request):\n ...\n ```\n\n" }, { "path": "guide/content/en/plugins/sanic-ext/openapi/ui.md", "content": "---\ntitle: Sanic Extensions - OAS UI\n---\n\n# UI\n\nSanic Extensions comes with both Redoc and Swagger interfaces. You have a choice to use one, or both of them. Out of the box, the following endpoints are setup for you, with the bare `/docs` displaying Redoc.\n\n- `/docs`\n- `/docs/openapi.json`\n- `/docs/redoc`\n- `/docs/swagger`\n- `/docs/openapi-config`\n\n## Config options\n\n| **Key** | **Type** | **Default** | **Desctiption** |\n| -------------------------- | --------------- | ------------------- | ------------------------------------------------------------ |\n| `OAS_IGNORE_HEAD` | `bool` | `True` | Whether to display `HEAD` endpoints. |\n| `OAS_IGNORE_OPTIONS` | `bool` | `True` | Whether to display `OPTIONS` endpoints. |\n| `OAS_PATH_TO_REDOC_HTML` | `Optional[str]` | `None` | Path to HTML to override the default Redoc HTML |\n| `OAS_PATH_TO_SWAGGER_HTML` | `Optional[str]` | `None` | Path to HTML to override the default Swagger HTML |\n| `OAS_UI_DEFAULT` | `Optional[str]` | `\"redoc\"` | Can be set to `redoc` or `swagger`. Controls which UI to display on the base route. If set to `None`, then the base route will not be setup. |\n| `OAS_UI_REDOC` | `bool` | `True` | Whether to enable Redoc UI. |\n| `OAS_UI_SWAGGER` | `bool` | `True` | Whether to enable Swagger UI. |\n| `OAS_URI_TO_CONFIG` | `str` | `\"/openapi-config\"` | URI path to the OpenAPI config used by Swagger |\n| `OAS_URI_TO_JSON` | `str` | `\"/openapi.json\"` | URI path to the JSON document. |\n| `OAS_URI_TO_REDOC` | `str` | `\"/redoc\"` | URI path to Redoc. |\n| `OAS_URI_TO_SWAGGER` | `str` | `\"/swagger\"` | URI path to Swagger. |\n| `OAS_URL_PREFIX` | `str` | `\"/docs\"` | URL prefix to use for the Blueprint for OpenAPI docs. |\n" }, { "path": "guide/content/en/plugins/sanic-ext/openapi.md", "content": "---\ntitle: Sanic Extensions - OAS\n---\n\n# Openapi\n\n- Adding documentation with decorators\n- Documenting CBV\n- Using autodoc\n- Rendering docs with redoc/swagger\n- Validation\n" }, { "path": "guide/content/en/plugins/sanic-ext/templating/html5tagger.md", "content": "---\ntitle: Sanic Extensions - html5tagger\n---\n\n# Coming soon\n\nSee [sanic-org/html5tagger on GitHub](https://github.com/sanic-org/html5tagger/)\n" }, { "path": "guide/content/en/plugins/sanic-ext/templating/jinja.md", "content": "---\ntitle: Sanic Extensions - Jinja\n---\n\n# Templating\n\nSanic Extensions can easily help you integrate templates into your route handlers. \n\n## Dependencies\n\n**Currently, we only support [Jinja](https://github.com/pallets/jinja/).**\n\n[Read the Jinja docs first](https://jinja.palletsprojects.com/en/3.1.x/) if you are unfamiliar with how to create templates.\n\nSanic Extensions will automatically setup and load Jinja for you if it is installed in your environment. Therefore, the only setup that you need to do is install Jinja:\n\n```\npip install Jinja2\n```\n\n## Rendering a template from a file\n\nThere are three (3) ways for you:\n\n1. Using a decorator to pre-load the template file\n1. Returning a rendered `HTTPResponse` object\n1. Hybrid pattern that creates a `LazyResponse`\n\nLet's imagine you have a file called `./templates/foo.html`:\n\n```html\n\n\n\n \n My Webpage\n \n\n \n

Hello, world!!!!

\n
    \n {% for item in seq %}\n
  • {{ item }}
    • \n {% endfor %}\n
\n \n\n\n```\n\nLet's see how you could render it with Sanic + Jinja.\n\n### Option 1 - as a decorator\n\n.. column::\n\n The benefit of this approach is that the templates can be predefined at startup time. This will mean that less fetching needs to happen in the handler, and should therefore be the fastest option.\n\n.. column::\n\n ```python\n @app.get(\"/\")\n @app.ext.template(\"foo.html\")\n async def handler(request: Request):\n return {\"seq\": [\"one\", \"two\"]}\n ```\n\n### Option 2 - as a return object\n\n.. column::\n\n This is meant to mimic the `text`, `json`, `html`, `file`, etc pattern of core Sanic. It will allow the most customization to the response object since it has direct control of it. Just like in other `HTTPResponse` objects, you can control headers, cookies, etc.\n\n.. column::\n\n ```python\n from sanic_ext import render\n\n @app.get(\"/alt\")\n async def handler(request: Request):\n return await render(\n \"foo.html\", context={\"seq\": [\"three\", \"four\"]}, status=400\n )\n ```\n\n### Option 3 - hybrid/lazy\n\n.. column::\n\n In this approach, the template is defined up front and not inside the handler (for performance). Then, the `render` function returns a `LazyResponse` that can be used to build a proper `HTTPResponse` inside the decorator.\n\n.. column::\n\n ```python\n from sanic_ext import render\n\n @app.get(\"/\")\n @app.ext.template(\"foo.html\")\n async def handler(request: Request):\n return await render(context={\"seq\": [\"five\", \"six\"]}, status=400)\n ```\n\n## Rendering a template from a string\n\n.. column::\n\n Sometimes you may want to write (or generate) your template inside of Python code and _not_ read it from an HTML file. In this case, you can still use the `render` function we saw above. Just use `template_source`.\n\n.. column::\n\n ```python\n from sanic_ext import render\n from textwrap import dedent\n\n @app.get(\"/\")\n async def handler(request):\n template = dedent(\"\"\"\n \n \n\n \n My Webpage\n \n\n \n

Hello, world!!!!

\n
    \n {% for item in seq %}\n
  • {{ item }}
    • \n {% endfor %}\n
\n \n\n \n \"\"\")\n return await render(\n template_source=template,\n context={\"seq\": [\"three\", \"four\"]},\n app=app,\n )\n ```\n\n\n\n.. note:: \n\n In this example, we use `textwrap.dedent` to remove the whitespace in the beginning of each line of the multi-line string. It is not necessary, but just a nice touch to keep both the code and the generated source clean.\n\n\n\n## Development and auto-reload\n\nIf auto-reload is turned on, then changes to your template files should trigger a reload of the server.\n\n## Configuration\n\nSee `templating_enable_async` and `templating_path_to_templates` in [settings](./configuration.md#settings).\n" }, { "path": "guide/content/en/plugins/sanic-ext/validation.md", "content": "---\ntitle: Sanic Extensions - Validation\n---\n\n# Validation\n\nOne of the most commonly implemented features of a web application is user-input validation. For obvious reasons, this is not only a security issue, but also just plain good practice. You want to make sure your data conforms to expectations, and throw a `400` response when it does not.\n\n## Implementation\n\n### Validation with Dataclasses\n\nWith the introduction of [Data Classes](https://docs.python.org/3/library/dataclasses.html), Python made it super simple to create objects that meet a defined schema. However, the standard library only supports type checking validation, **not** runtime validation. Sanic Extensions adds the ability to do runtime validations on incoming requests using `dataclasses` out of the box. If you also have either `pydantic` or `attrs` installed, you can alternatively use one of those libraries.\n\n.. column::\n\n First, define a model.\n\n.. column::\n\n ```python\n @dataclass\n class SearchParams:\n q: str\n ```\n\n\n.. column::\n\n Then, attach it to your route\n\n.. column::\n\n ```python\n from sanic_ext import validate\n\n @app.route(\"/search\")\n @validate(query=SearchParams)\n async def handler(request, query: SearchParams):\n return json(asdict(query))\n ```\n\n\n.. column::\n\n You should now have validation on the incoming request.\n\n.. column::\n\n ```\n $ curl localhost:8000/search \n ⚠️ 400 — Bad Request\n ====================\n Invalid request body: SearchParams. Error: missing a required argument: 'q'\n ```\n ```\n $ curl localhost:8000/search\\?q=python \n {\"q\":\"python\"}\n ```\n\n### Validation with Pydantic\n\nYou can use Pydantic models also.\n\n.. column::\n\n First, define a model.\n\n.. column::\n\n ```python\n class Person(BaseModel):\n name: str\n age: int\n ```\n\n\n.. column::\n\n Then, attach it to your route\n\n.. column::\n\n ```python\n from sanic_ext import validate\n\n @app.post(\"/person\")\n @validate(json=Person)\n async def handler(request, body: Person):\n return json(body.dict())\n ```\n\n\n.. column::\n\n You should now have validation on the incoming request.\n\n.. column::\n\n ```\n $ curl localhost:8000/person -d '{\"name\": \"Alice\", \"age\": 21}' -X POST \n {\"name\":\"Alice\",\"age\":21}\n ```\n\n### Validation with Attrs\n\nYou can use Attrs also.\n\n.. column::\n\n First, define a model.\n\n.. column::\n\n ```python\n @attrs.define\n class Person:\n name: str\n age: int\n\n ```\n\n\n.. column::\n\n Then, attach it to your route\n\n.. column::\n\n ```python\n from sanic_ext import validate\n\n @app.post(\"/person\")\n @validate(json=Person)\n async def handler(request, body: Person):\n return json(attrs.asdict(body))\n ```\n\n\n.. column::\n\n You should now have validation on the incoming request.\n\n.. column::\n\n ```\n $ curl localhost:8000/person -d '{\"name\": \"Alice\", \"age\": 21}' -X POST \n {\"name\":\"Alice\",\"age\":21}\n ```\n\n## What can be validated?\n\nThe `validate` decorator can be used to validate incoming user data from three places: JSON body data (`request.json`), form body data (`request.form`), and query parameters (`request.args`).\n\n.. column::\n\n As you might expect, you can attach your model using the keyword arguments of the decorator.\n\n.. column::\n\n ```python\n @validate(\n json=ModelA,\n query=ModelB,\n form=ModelC,\n )\n ```\n\n" }, { "path": "guide/content/en/plugins/sanic-testing/README.md", "content": "" }, { "path": "guide/content/en/plugins/sanic-testing/clients.md", "content": "---\ntitle: Sanic Testing - Test Clients\n---\n\n# Test Clients\n\nThere are three different test clients available to you, each of them presents different capabilities.\n\n## Regular sync client: `SanicTestClient`\n\nThe `SanicTestClient` runs an actual version of the Sanic Server on your local network to run its tests. Each time it calls an endpoint it will spin up a version of the application and bind it to a socket on the host OS. Then, it will use `httpx` to make calls directly to that application.\n\nThis is the typical way that Sanic applications are tested.\n\n.. column::\n\n Once installing Sanic Testing, the regular `SanicTestClient` can be used without further setup. This is because Sanic does the leg work for you under the hood. \n\n.. column::\n\n ```python\n app.test_client.get(\"/path/to/endpoint\")\n ```\n\n.. column::\n\n However, you may find it desirable to instantiate the client yourself.\n\n.. column::\n\n ```python\n from sanic_testing.testing import SanicTestClient\n\n test_client = SanicTestClient(app)\n test_client.get(\"/path/to/endpoint\")\n ```\n\n.. column::\n\n A third option for starting the test client is to use the `TestManager`. This is a convenience object that sets up both the `SanicTestClient` and the `SanicASGITestClient`.\n\n.. column::\n\n ```python\n from sanic_testing import TestManager\n\n mgr = TestManager(app)\n app.test_client.get(\"/path/to/endpoint\")\n # or\n mgr.test_client.get(\"/path/to/endpoint\")\n ```\n\nYou can make a request by using one of the following methods\n\n- `SanicTestClient.get`\n- `SanicTestClient.post`\n- `SanicTestClient.put`\n- `SanicTestClient.patch`\n- `SanicTestClient.delete`\n- `SanicTestClient.options`\n- `SanicTestClient.head`\n- `SanicTestClient.websocket`\n- `SanicTestClient.request`\n\nYou can use these methods *almost* identically as you would when using `httpx`. Any argument that you would pass to `httpx` will be accepted, **with one caveat**: If you are using `test_client.request` and want to manually specify the HTTP method, you should use: `http_method`:\n\n```python\ntest_client.request(\"/path/to/endpoint\", http_method=\"get\")\n```\n\n## ASGI async client: `SanicASGITestClient`\n\nUnlike the `SanicTestClient` that spins up a server on every request, the `SanicASGITestClient` does not. Instead it makes use of the `httpx` library to execute Sanic as an ASGI application to reach inside and execute the route handlers.\n\n.. column::\n\n This test client provides all of the same methods and generally works as the `SanicTestClient`. The only difference is that you will need to add an `await` to each call:\n\n.. column::\n\n ```python\n await app.test_client.get(\"/path/to/endpoint\")\n ```\n\nThe `SanicASGITestClient` can be used in the exact same three ways as the `SanicTestClient`.\n\n\n.. note::\n\n The `SanicASGITestClient` does not need to only be used with ASGI applications. The same way that the `SanicTestClient` does not need to only test sync endpoints. Both of these clients are capable of testing *any* Sanic application.\n\n\n## Persistent service client: `ReusableClient`\n\nThis client works under a similar premise as the `SanicTestClient` in that it stands up an instance of your application and makes real HTTP requests to it. However, unlike the `SanicTestClient`, when using the `ReusableClient` you control the lifecycle of the application.\n\nThat means that every request **does not** start a new web server. Instead you will start the server and stop it as needed and can make multiple requests to the same running instance.\n\n.. column::\n\n Unlike the other two clients, you **must** instantiate this client for use:\n\n.. column::\n\n ```python\n from sanic_testing.reusable import ReusableClient\n\n client = ReusableClient(app)\n ```\n\n.. column::\n\n Once created, you will use the client inside of a context manager. Once outside of the scope of the manager, the server will shutdown.\n\n.. column::\n\n ```python\n from sanic_testing.reusable import ReusableClient\n\n def test_multiple_endpoints_on_same_server(app):\n client = ReusableClient(app)\n with client:\n _, response = client.get(\"/path/to/1\")\n assert response.status == 200\n\n _, response = client.get(\"/path/to/2\")\n assert response.status == 200\n ```\n" }, { "path": "guide/content/en/plugins/sanic-testing/getting-started.md", "content": "---\ntitle: Sanic Testing - Getting Started\n---\n\n# Getting Started\n\nSanic Testing is the *official* testing client for Sanic. Its primary use is to power the tests of the Sanic project itself. However, it is also meant as an easy-to-use client for getting your API tests up and running quickly.\n\n## Minimum requirements\n\n- **Python**: 3.7+\n- **Sanic**: 21.3+\n\nVersions of Sanic older than 21.3 have this module integrated into Sanic itself as `sanic.testing`.\n\n## Install\n\nSanic Testing can be installed from PyPI:\n\n```\npip install sanic-testing\n```\n\n## Basic Usage\n\nAs long as the `sanic-testing` package is in the environment, there is nothing you need to do to start using it.\n\n### Writing a sync test\n\nIn order to use the test client, you just need to access the property `test_client` on your application instance:\n\n```python\nimport pytest\nfrom sanic import Sanic, response\n\n@pytest.fixture\ndef app():\n sanic_app = Sanic(\"TestSanic\")\n\n @sanic_app.get(\"/\")\n def basic(request):\n return response.text(\"foo\")\n\n return sanic_app\n\ndef test_basic_test_client(app):\n request, response = app.test_client.get(\"/\")\n\n assert request.method.lower() == \"get\"\n assert response.body == b\"foo\"\n assert response.status == 200\n```\n\n### Writing an async test\n\nIn order to use the async test client in `pytest`, you should install the `pytest-asyncio` plugin.\n\n```\npip install pytest-asyncio\n```\n\nYou can then create an async test and use the ASGI client:\n\n```python\nimport pytest\nfrom sanic import Sanic, response\n\n@pytest.fixture\ndef app():\n sanic_app = Sanic(__name__)\n\n @sanic_app.get(\"/\")\n def basic(request):\n return response.text(\"foo\")\n\n return sanic_app\n\n@pytest.mark.asyncio\nasync def test_basic_asgi_client(app):\n request, response = await app.asgi_client.get(\"/\")\n\n assert request.method.lower() == \"get\"\n assert response.body == b\"foo\"\n assert response.status == 200\n```\n" }, { "path": "guide/content/en/release-notes/2021/v21.12.md", "content": "---\ntitle: Version 21.12 (LTS)\n---\n\n# Version 21.12 (LTS)\n\n.. toc::\n\n## Introduction\n\nThis is the final release of the version 21 [release cycle](../../organization/policies.md#release-schedule). Version 21 will now enter long-term support and will be supported for two years until December 2023.\n\n## What to know\n\nMore details in the [Changelog](https://sanic.readthedocs.io/en/stable/sanic/changelog.html). Notable new or breaking features, and what to upgrade...\n\n### Strict application and blueprint names\n\nIn [v21.6](./v21.6.md#stricter-application-and-blueprint-names-and-deprecation) application and blueprint names were required to conform to a new set of restrictions. That change is now being enforced at startup time.\n\nNames **must**:\n\n1. Only use alphanumeric characters (`a-zA-Z0-9`)\n2. May contain a hyphen (`-`) or an underscore (`_`)\n3. Must begin with a letter or underscore (`a-zA-Z_`)\n\n### Strict application and blueprint properties\n\nThe old leniency to allow directly setting properties of a `Sanic` or `Blueprint` object was deprecated and no longer allowed. You must use the `ctx` object.\n\n```python\napp = Sanic(\"MyApp\")\napp.ctx.db = Database()\n```\n\n### Removals\n\nThe following deprecated features no longer exist:\n\n- `sanic.exceptions.abort`\n- `sanic.views.CompositionView`\n- `sanic.response.StreamingHTTPResponse`\n\n### Upgrade your streaming responses (if not already)\n\nThe `sanic.response.stream` response method has been **deprecated** and will be removed in v22.6. If you are sill using an old school streaming response, please upgrade it.\n\n**OLD - Deprecated**\n\n```python\nasync def sample_streaming_fn(response):\n await response.write(\"foo,\")\n await response.write(\"bar\")\n\n@app.route(\"/\")\nasync def test(request: Request):\n return stream(sample_streaming_fn, content_type=\"text/csv\")\n```\n\n**Current**\n\n```python\nasync def sample_streaming_fn(response):\n await response.write(\"foo,\")\n await response.write(\"bar\")\n\n@app.route(\"/\")\nasync def test(request: Request):\n response = await request.respond(content_type=\"text/csv\")\n await response.send(\"foo,\")\n await response.send(\"bar\")\n```\n\n### CLI overhaul and MOTD (Message of the Day)\n\nThe Sanic CLI has received a fairly extensive upgrade. It adds a bunch of new features to make it on par with `app.run()`. It also includes a new MOTD display to provide quick, at-a-glance highlights about your running environment. The MOTD is TTY-aware, and therefore will be less verbose in server logs. It is mainly intended as a convenience during application development.\n\n```\n$ sanic --help\nusage: sanic [-h] [--version] [--factory] [-s] [-H HOST] [-p PORT] [-u UNIX] [--cert CERT] [--key KEY] [--tls DIR] [--tls-strict-host]\n [-w WORKERS | --fast] [--access-logs | --no-access-logs] [--debug] [-d] [-r] [-R PATH] [--motd | --no-motd] [-v]\n [--noisy-exceptions | --no-noisy-exceptions]\n module\n\n ▄███ █████ ██ ▄█▄ ██ █ █ ▄██████████\n ██ █ █ █ ██ █ █ ██\n ▀███████ ███▄ ▀ █ █ ██ ▄ █ ██\n ██ █████████ █ ██ █ █ ▄▄\n ████ ████████▀ █ █ █ ██ █ ▀██ ███████\n\n To start running a Sanic application, provide a path to the module, where\n app is a Sanic() instance:\n\n $ sanic path.to.server:app\n\n Or, a path to a callable that returns a Sanic() instance:\n\n $ sanic path.to.factory:create_app --factory\n\n Or, a path to a directory to run as a simple HTTP server:\n\n $ sanic ./path/to/static --simple\n\nRequired\n========\n Positional:\n module Path to your Sanic app. Example: path.to.server:app\n If running a Simple Server, path to directory to serve. Example: ./\n\nOptional\n========\n General:\n -h, --help show this help message and exit\n --version show program's version number and exit\n\n Application:\n --factory Treat app as an application factory, i.e. a () -> callable\n -s, --simple Run Sanic as a Simple Server, and serve the contents of a directory\n (module arg should be a path)\n\n Socket binding:\n -H HOST, --host HOST Host address [default 127.0.0.1]\n -p PORT, --port PORT Port to serve on [default 8000]\n -u UNIX, --unix UNIX location of unix socket\n\n TLS certificate:\n --cert CERT Location of fullchain.pem, bundle.crt or equivalent\n --key KEY Location of privkey.pem or equivalent .key file\n --tls DIR TLS certificate folder with fullchain.pem and privkey.pem\n May be specified multiple times to choose multiple certificates\n --tls-strict-host Only allow clients that send an SNI matching server certs\n\n Worker:\n -w WORKERS, --workers WORKERS Number of worker processes [default 1]\n --fast Set the number of workers to max allowed\n --access-logs Display access logs\n --no-access-logs No display access logs\n\n Development:\n --debug Run the server in debug mode\n -d, --dev Currently is an alias for --debug. But starting in v22.3, \n --debug will no longer automatically trigger auto_restart. \n However, --dev will continue, effectively making it the \n same as debug + auto_reload.\n -r, --reload, --auto-reload Watch source directory for file changes and reload on changes\n -R PATH, --reload-dir PATH Extra directories to watch and reload on changes\n\n Output:\n --motd Show the startup display\n --no-motd No show the startup display\n -v, --verbosity Control logging noise, eg. -vv or --verbosity=2 [default 0]\n --noisy-exceptions Output stack traces for all exceptions\n --no-noisy-exceptions No output stack traces for all exceptions\n```\n\n### Server running modes and changes coming to `debug`\n\nThere are now two running modes: `DEV` and `PRODUCTION`. By default, Sanic server will run under `PRODUCTION` mode. This is intended for deployments.\n\nCurrently, `DEV` mode will operate very similarly to how `debug=True` does in older Sanic versions. However, in v22.3. `debug=True` will **no longer** enable auto-reload. If you would like to have debugging and auto-reload, you should enable `DEV` mode.\n\n**DEVELOPMENT**\n\n```\n$ sanic server:app --dev\n```\n\n```python\napp.run(debug=True, auto_reload=True)\n```\n\n**PRODUCTION**\n\n```\n$ sanic server:app\n```\n\n```python\napp.run()\n```\n\nBeginning in v22.3, `PRODUCTION` mode will no longer enable access logs by default.\n\nA summary of the changes are as follows:\n\n| Flag | Mode | Tracebacks | Logging | Access logs | Reload | Max workers |\n|---------|-------|------------|---------|-------------|--------|-------------|\n| --debug | DEBUG | yes | DEBUG | yes | ^1 | |\n| | PROD | no | INFO ^2 | ^3 | | |\n| --dev | DEBUG | yes | DEBUG | yes | yes | |\n| --fast | | | | | | yes |\n\n- ^1 `--debug` to deprecate auto-reloading and remove in 22.3\n- ^2 After 22.3 this moves to WARNING\n- ^3 After 22.3: no\n\n### Max allowed workers\n\nYou can easily spin up the maximum number of allowed workers using `--fast`.\n\n```\n$ sanic server:app --fast\n```\n\n```python\napp.run(fast=True)\n```\n\n### First-class Sanic Extensions support\n\n[Sanic Extensions](../../plugins/sanic-ext/getting-started.md) provides a number of additional features specifically intended for API developers. You can now easily implement all of the functionality it has to offer without additional setup as long as the package is in the environment. These features include:\n\n- Auto create `HEAD`, `OPTIONS`, and `TRACE` endpoints\n- CORS protection\n- Predefined, endpoint-specific response serializers\n- Dependency injection into route handlers\n- OpenAPI documentation with Redoc and/or Swagger\n- Request query arguments and body input validation\n\nThe preferred method is to install it along with Sanic, but you can also install the packages on their own.\n\n.. column::\n\n ```\n $ pip install sanic[ext]\n ```\n\n.. column::\n\n ```\n $ pip install sanic sanic-ext\n ```\n\nAfter that, no additional configuration is required. Sanic Extensions will be attached to your application and provide all of the additional functionality with **no further configuration**.\n\nIf you want to change how it works, or provide additional configuration, you can change Sanic extensions using `app.extend`. The following examples are equivalent. The `Config` object is to provide helpful type annotations for IDE development.\n\n.. column::\n\n ```python\n # This is optional, not required\n app = Sanic(\"MyApp\")\n app.extend(config={\"oas_url_prefix\": \"/apidocs\"})\n ```\n\n.. column::\n\n ```python\n # This is optional, not required\n app = Sanic(\"MyApp\")\n app.config.OAS_URL_PREFIX = \"/apidocs\"\n ```\n\n.. column::\n\n ```python\n # This is optional, not required\n from sanic_ext import Config\n\n app = Sanic(\"MyApp\")\n app.extend(config=Config(oas_url_prefix=\"/apidocs\"))\n ```\n\n.. column::\n\n\n ### Contextual exceptions\n\n In [v21.9](./v21.9.md#default-exception-messages) we added default messages to exceptions that simplify the ability to consistently raise exceptions throughout your application.\n\n ```python\n class TeapotError(SanicException):\n status_code = 418\n message = \"Sorry, I cannot brew coffee\"\n\n raise TeapotError\n ```\n\n But this lacked two things:\n\n 1. A dynamic and predictable message format\n 2. The ability to add additional context to an error message (more on this in a moment)\n\n The current release allows any Sanic exception to have additional information to when raised to provide context when writing an error message:\n\n ```python\n class TeapotError(SanicException):\n status_code = 418\n\n @property\n def message(self):\n return f\"Sorry {self.extra['name']}, I cannot make you coffee\"\n\n raise TeapotError(extra={\"name\": \"Adam\"})\n ```\n\n The new feature allows the passing of `extra` meta to the exception instance. This `extra` info object **will be suppressed** when in `PRODUCTION` mode, but displayed in `DEVELOPMENT` mode.\n\n.. column::\n \n **PRODUCTION**\n\n ![image](https://user-images.githubusercontent.com/166269/139014161-cda67cd1-843f-4ad2-9fa1-acb94a59fc4d.png)\n\n.. column::\n\n **DEVELOPMENT**\n\n ![image](https://user-images.githubusercontent.com/166269/139014121-0596b084-b3c5-4adb-994e-31ba6eba6dad.png)\n\nGetting back to item 2 from above: _The ability to add additional context to an error message_\n\nThis is particularly useful when creating microservices or an API that you intend to pass error messages back in JSON format. In this use case, we want to have some context around the exception beyond just a parseable error message to return details to the client.\n\n```python\nraise TeapotError(context={\"foo\": \"bar\"})\n```\n\nThis is information **that we want** to always be passed in the error (when it is available). Here is what it should look like:\n\n.. column::\n\n **PRODUCTION**\n\n ```json\n {\n \"description\": \"I'm a teapot\",\n \"status\": 418,\n \"message\": \"Sorry Adam, I cannot make you coffee\",\n \"context\": {\n \"foo\": \"bar\"\n }\n }\n ```\n\n.. column::\n\n **DEVELOPMENT**\n\n ```json\n {\n \"description\": \"I'm a teapot\",\n \"status\": 418,\n \"message\": \"Sorry Adam, I cannot make you coffee\",\n \"context\": {\n \"foo\": \"bar\"\n },\n \"extra\": {\n \"name\": \"Adam\",\n \"more\": \"lines\",\n \"complex\": {\n \"one\": \"two\"\n }\n },\n \"path\": \"/\",\n \"args\": {},\n \"exceptions\": [\n {\n \"type\": \"TeapotError\",\n \"exception\": \"Sorry Adam, I cannot make you coffee\",\n \"frames\": [\n {\n \"file\": \"handle_request\",\n \"line\": 83,\n \"name\": \"handle_request\",\n \"src\": \"\"\n },\n {\n \"file\": \"/tmp/p.py\",\n \"line\": 17,\n \"name\": \"handler\",\n \"src\": \"raise TeapotError(\"\n }\n ]\n }\n ]\n }\n ```\n\n### Background task management\n\nWhen using the `app.add_task` method to create a background task, there now is the option to pass an optional `name` keyword argument that allows it to be fetched, or cancelled.\n\n```python\napp.add_task(dummy, name=\"dummy_task\")\ntask = app.get_task(\"dummy_task\")\n\napp.cancel_task(\"dummy_task\")\n```\n\n### Route context kwargs in definitions\n\nWhen a route is defined, you can add any number of keyword arguments with a `ctx_` prefix. These values will be injected into the route `ctx` object.\n\n```python\n@app.get(\"/1\", ctx_label=\"something\")\nasync def handler1(request):\n ...\n\n@app.get(\"/2\", ctx_label=\"something\")\nasync def handler2(request):\n ...\n\n@app.get(\"/99\")\nasync def handler99(request):\n ...\n\n@app.on_request\nasync def do_something(request):\n if request.route.ctx.label == \"something\":\n ...\n```\n\n### Blueprints can be registered at any time\n\nIn previous versions of Sanic, there was a strict ordering of when a Blueprint could be attached to an application. If you ran `app.blueprint(bp)` *before* attaching all objects to the Blueprint instance, they would be missed.\n\nNow, you can attach a Blueprint at anytime and everything attached to it will be included at startup.\n\n### Noisy exceptions (force all exceptions to logs)\n\nThere is a new `NOISY_EXCEPTIONS` config value. When it is `False` (which is the default), Sanic will respect the `quiet` property of any `SanicException`. This means that an exception with `quiet=True` will not be displayed to the log output.\n\nHowever, when setting `NOISY_EXCEPTIONS=True`, all exceptions will be logged regardless of the `quiet` value.\n\nThis can be helpful when debugging.\n\n```python\napp.config.NOISY_EXCEPTIONS = True\n```\n\n### Signal events as `Enum`\n\nThere is an `Enum` with all of the built-in signal values for convenience.\n\n```python\nfrom sanic.signals import Event\n\n@app.signal(Event.HTTP_LIFECYCLE_BEGIN)\nasync def connection_opened(conn_info):\n ...\n```\n\n### Custom type casting of environment variables\n\nBy default, Sanic will convert an `int`, `float`, or a `bool` value when applying environment variables to the `config` instance. You can extend this with your own converter:\n\n```python\napp = Sanic(..., config=Config(converters=[UUID]))\n```\n\n### Disable `uvloop` by configuration value\n\nThe usage of `uvloop` can be controlled by configuration value:\n\n```python\napp.config.USE_UVLOOP = False\n```\n\n### Run Sanic server with multiple TLS certificates\n\nSanic can be run with multiple TLS certificates:\n\n```python\napp.run(\n ssl=[\n \"/etc/letsencrypt/live/example.com/\",\n \"/etc/letsencrypt/live/mysite.example/\",\n ]\n)\n```\n\n## News\n\n### Coming Soon: Python Web Development with Sanic\n\nA book about Sanic is coming soon by one of the core developers, [@ahopkins](https://github.com/ahopkins).\n\nLearn more at [sanicbook.com](https://sanicbook.com).\n\n> Get equipped with the practical knowledge of working with Sanic to increase the performance and scalability of your web applications. While doing that, we will level-up your development skills as you learn to customize your application to meet the changing business needs without having to significantly over-engineer the app.\n\nA portion of book proceeds goes into the Sanic Community Organization to help fund the development and operation of Sanic. So, buying the book is another way you can support Sanic.\n\n### Dark mode for the docs\n\nIf you have not already noticed, this Sanic website is now available in a native dark mode. You can toggle the theme at the top right of the page.\n\n## Thank you\n\nThank you to everyone that participated in this release: :clap:\n\n[@adarsharegmi](https://github.com/adarsharegmi)\n[@ahopkins](https://github.com/ahopkins)\n[@ashleysommer](https://github.com/ashleysommer)\n[@ChihweiLHBird](https://github.com/ChihweiLHBird)\n[@cnicodeme](https://github.com/cnicodeme)\n[@kianmeng](https://github.com/kianmeng)\n[@meysam81](https://github.com/meysam81)\n[@nuxion](https://github.com/nuxion)\n[@prryplatypus](https://github.com/prryplatypus)\n[@realDragonium](https://github.com/realDragonium)\n[@SaidBySolo](https://github.com/SaidBySolo)\n[@sjsadowski](https://github.com/sjsadowski)\n[@Tronic](https://github.com/tronic)\n[@Varriount](https://github.com/Varriount)\n[@vltr](https://github.com/vltr)\n[@whos4n3](https://github.com/whos4n3)\n\nAnd, a special thank you to [@miss85246](https://github.com/miss85246) and [@ZinkLu](https://github.com/ZinkLu) for their tremendous work keeping the documentation synced and translated into Chinese.\n\n---\n\nIf you enjoy the project, please consider contributing. Of course we love code contributions, but we also love contributions in any form. Consider writing some documentation, showing off use cases, joining conversations and making your voice known, and if you are able: [financial contributions](https://opencollective.com/sanic-org/).\n" }, { "path": "guide/content/en/release-notes/2021/v21.3.md", "content": "---\ntitle: Version 21.3\n---\n\n# Version 21.3\n\n.. toc::\n\n## Introduction\n\nSanic is now faster.\n\nWell, it already was fast. But with the first iteration of the v21 release, we incorporated a few major milestones that have made some tangible improvements. These encompass some ideas that have been in the works for years, and have finally made it into the released version.\n\n\n.. warning:: Breaking changes\n\n Version 21.3 introduces a lot of new features. But, it also includes some breaking changes. This is why these changes were introduced after the last LTS. If you rely upon something that has been removed, you should continue to use v20.12LTS until you are able to upgrade.\n\n ```bash\n pip install \"sanic>=20.12,<20.13\"\n pip freeze > requirements.txt\n ```\n\n For most typical installations, you should be able to upgrade without a problem.\n\n\n## What to know\n\nNotable new or breaking features, and what to upgrade...\n\n### Python 3.7+ Only\n\nThis version drops Python 3.6 support. Version 20.12LTS will continue to support Python 3.6 until its EOL in December, 2022, and version 19.12LTS will support it until its EOL in December, 2021.\n\nRead more about our [LTS policy](../../organization/policies.md#long-term-support-v-interim-releases).\n\n### Streaming as first class citizen\n\nThe biggest speed improvement came from unifying the request/response cycle into a single flow. Previously, there was a difference between regular cycles, and streaming cycles. This has been simplified under the hood, even though the API is staying the same right now for compatibility. The net benefit is that **all** requests now should see a new benefit.\n\nRead more about [streaming changes](../../guide/advanced/streaming.md#response-streaming).\n\n### Router overhaul\n\nThe old Sanic router was based upon regular expressions. In addition it suffered from a number of quirks that made it hard to modify at run time, and resulted in some performance issues. This change has been years in the making and now [converts the router to a compiled tree at startup](https://community.sanicframework.org/t/a-fast-new-router/649/41). Look for additional improvements throughout the year.\n\nThe outward facing API has kept backwards compatibility. However, if you were accessing anything inside the router specifically, you many notice some changes. For example:\n\n1. `Router.get()` has a new return value\n2. `Route` is now a proper class object and not a `namedtuple`\n3. If building the router manually, you will need to call `Router.finalize()` before it is usable\n4. There is a new `` pattern that can be matched in your routes\n5. You cannot startup an application without at least one route defined\n\nThe router is now located in its own repository: [sanic-org/sanic-router](https://github.com/sanic-org/sanic-router) and is also its own [standalone package on PyPI](https://pypi.org/project/sanic-routing/).\n\n### Signals API ⭐️\n\n_BETA Feature: API to be finalized in v21.6_\n\nA side benefit of the new router is that it can do double duty also powering the [new signals API](https://github.com/sanic-org/sanic/issues/1630). This feature is being released for public usage now, and likely the public API will not change in its final form.\n\nThe core ideas of this feature are:\n\n1. to allow the developer greater control and access to plugging into the server and request lifecycles,\n2. to provide new tools to synchronize and send messages through your application, and\n3. to ultimately further increase performance.\n\nThe API introduces three new methods:\n\n- `@app.signal(...)` - For defining a signal handler. It looks and operates very much like a route. Whenever that signal is dispatched, this handler will be executed.\n- `app.event(...)` - An awaitable that can be used anywhere in your application to pause execution until the event is triggered.\n- `app.dispatch(...)` - Trigger an event and cause the signal handlers to execute.\n\n```python\n@app.signal(\"foo.bar.\")\nasync def signal_handler(thing, **kwargs):\n print(f\"[signal_handler] {thing=}\", kwargs)\n\nasync def wait_for_event(app):\n while True:\n print(\"> waiting\")\n await app.event(\"foo.bar.*\")\n print(\"> event found\\n\")\n\n@app.after_server_start\nasync def after_server_start(app, loop):\n app.add_task(wait_for_event(app))\n\n@app.get(\"/\")\nasync def trigger(request):\n await app.dispatch(\"foo.bar.baz\")\n return response.text(\"Done.\")\n```\n\n### Route naming\n\nRoutes used to be referenced by both `route.name` and `route.endpoint`. While similar, they were slightly different. Now, all routes will be **consistently** namespaced and referenced.\n\n```text\n.[optional:.]\n```\n\nThis new \"name\" is assigned to the property `route.name`. We are deprecating `route.endpoint`, and will remove that property in v21.9. Until then, it will be an alias for `route.name`.\n\nIn addition, naming prefixes that had been in use for things like static, websocket, and blueprint routes have been removed.\n\n### New decorators\n\nSeveral new convenience decorators to help IDEs with autocomplete.\n\n```python\n# Alias to @app.listener(\"...\")\n@app.before_server_start\n@app.after_server_stop\n@app.before_server_start\n@app.after_server_stop\n\n# Alias to @app.middleware(\"...\")\n@app.on_request\n@app.on_response\n```\n\n### Unquote in route\n\nIf you have a route that uses non-ascii characters, Sanic will no longer `unquote` the text for you. You will need to specifically tell the route definition that it should do so.\n\n```python\n@app.route(\"/overload/\", methods=[\"GET\"], unquote=True)\nasync def handler2(request, param):\n return text(\"OK2 \" + param)\n\nrequest, response = app.test_client.get(\"/overload/您好\")\nassert response.text == \"OK2 您好\"\n```\n\nIf you forget to do so, your text will remain encoded.\n\n### Alter `Request.match_info`\n\nThe `match_info` has always provided the data for the matched path parameters. You now have access to modify that, for example in middleware.\n\n```python\n@app.on_request\ndef convert_to_snake_case(request):\n request.match_info = to_snake(request.match_info)\n```\n\n### Version types in routes\n\nThe `version` argument in routes can now be:\n\n- `str`\n- `int`\n- `float`\n\n```python\n@app.route(\"/foo\", version=\"2.1.1\")\n@app.route(\"/foo\", version=2)\n@app.route(\"/foo\", version=2.1)\n```\n### Safe method handling with body\n\nRoute handlers for `GET`, `HEAD`, `OPTIONS` and `DELETE` will not decode any HTTP body passed to it. You can override this:\n\n```python\n@app.delete(..., ignore_body=False)\n```\n\n### Application, Blueprint and Blueprint Group parity\n\nThe `Sanic` and `Blueprint` classes share a common base. Previously they duplicated a lot of functionality, that lead to slightly different implementations between them. Now that they both inherit the same base class, developers and plugins should have a more consistent API to work with.\n\nAlso, Blueprint Groups now also support common URL extensions like the `version` and `strict_slashes` keyword arguments.\n\n### Dropped `httpx` from dependencies\n\nThere is no longer a dependency on `httpx`.\n\n### Removed `testing` library\n\nSanic internal testing client has been removed. It is now located in its own repository: [sanic-org/sanic-testing](https://github.com/sanic-org/sanic-testing) and is also its own [standalone package on PyPI](https://pypi.org/project/sanic-testing/).\n\nIf you have `sanic-testing` installed, it will be available and usable on your `Sanic()` application instances as before. So, the **only** change you will need to make is to add `sanic-testing` to your test suite requirements.\n\n### Application and connection level context (`ctx`) objects\n\nVersion 19.9 [added ](https://github.com/sanic-org/sanic/pull/1666/files) the `request.ctx` API. This helpful construct easily allows for attaching properties and data to a request object (for example, in middleware), and reusing the information elsewhere int he application.\n\nSimilarly, this concept is being extended in two places:\n\n1. the application instance, and\n2. a transport connection.\n\n#### Application context\n\nA common use case is to attach properties to the app instance. For the sake of consistency, and to avoid the issue of name collision with Sanic properties, the `ctx` object now exists on `Sanic` instances.\n\n```python\n@app.before_server_startup\nasync def startup_db(app, _):\n # WRONG\n app.db = await connect_to_db()\n\n # CORRECT\n app.ctx.db = await connect_to_db()\n```\n\n#### Connection context\n\nWhen a client sends a keep alive header, Sanic will attempt to keep the transport socket [open for a period of time](../../guide/running/configuration.md#keep-alive-timeout). That transport object now has a `ctx` object available on it. This effectively means that multiple requests from a single client (where the transport layer is being reused) may share state.\n\n```python\n@app.on_request\nasync def increment_foo(request):\n if not hasattr(request.conn_info.ctx, \"foo\"):\n request.conn_info.ctx.foo = 0\n request.conn_info.ctx.foo += 1\n\n@app.get(\"/\")\nasync def count_foo(request):\n return text(f\"request.conn_info.ctx.foo={request.conn_info.ctx.foo}\")\n```\n\n```bash\n$ curl localhost:8000 localhost:8000 localhost:8000\nrequest.conn_info.ctx.foo=1\nrequest.conn_info.ctx.foo=2\nrequest.conn_info.ctx.foo=3\n```\n\n\n.. warning:: \n\n Connection level context is an experimental feature, and should be finalized in v21.6.\n\n\n\n## News\n\n### A NEW frontpage 🎉\n\nWe have split the documentation into two. The docstrings inside the codebase will still continue to build sphinx docs to ReadTheDocs. However, it will be limited to API documentation. The new frontpage will house the \"Sanic User Guide\".\n\nThe new site runs on Vuepress. Contributions are welcome. We also invite help in translating the documents.\n\nAs a part of this, we also freshened up the RTD documentation and changed it to API docs only.\n\n### Chat has moved to Discord\n\nThe Gitter chatroom has taken one step closer to being phased out. In its place we opened a [Discord server](https://discord.gg/FARQzAEMAA).\n\n### Open Collective\n\nThe Sanic Community Organization has [opened a page on Open Collective](https://opencollective.com/sanic-org) to enable anyone that would like to financially support the development of Sanic.\n\n### 2021 Release Managers\n\nThank you to @sjsadowski and @yunstanford for acting as release managers for both 2019 and 2020. This year's release managers are @ahopkins and @vltr.\n\n## Thank you\n\nThank you to everyone that participated in this release: :clap:\n\n[@ahopkins](https://github.com/ahopkins) [@akshgpt7](https://github.com/akshgpt7) [@artcg](https://github.com/artcg) [@ashleysommer](https://github.com/ashleysommer) [@elis-k](https://github.com/elis-k) [@harshanarayana](https://github.com/harshanarayana) [@sjsadowski](https://github.com/sjsadowski) [@tronic](https://github.com/tronic) [@vltr](https://github.com/vltr),\n\nTo [@ConnorZhang](https://github.com/miss85246) and [@ZinkLu](https://github.com/ZinkLu) for translating our documents into Chinese,\n\n---\n\nMake sure to checkout the changelog to get links to all the PRs, etc.\n" }, { "path": "guide/content/en/release-notes/2021/v21.6.md", "content": "---\ntitle: Version 21.6\n---\n\n# Version 21.6\n\n.. toc::\n\n## Introduction\n\nThis is the second release of the version 21 [release cycle](../../organization/policies.md#release-schedule). There will be one more release in September before version 21 is \"finalized\" in the December long-term support version. One thing users may have noticed starting in 21.3, the router was moved to its own package: [`sanic-routing`](https://pypi.org/project/sanic-routing). This change is likely to stay for now. Starting with this release, the minimum required version is 0.7.0.\n\n## What to know\n\nMore details in the [Changelog](https://sanic.readthedocs.io/en/stable/sanic/changelog.html). Notable new or breaking features, and what to upgrade...\n\n### Deprecation of `StreamingHTTPResponse`\n\nThe use of `StreamingHTTPResponse` has been deprecated and will be removed in the 21.12 release. This impacts both `sanic.response.stream` and `sanic.response.file_stream`, which both under the hood instantiate `StreamingHTTPResponse`. \n\nAlthough the exact migration path has yet to be determined, `sanic.response.stream` and `sanic.response.file_stream` will continue to exist in v21.12 in some form as convenience operators. Look for more details throughout this Summer as we hope to have this finalized by the September release.\n\n### Deprecation of `CompositionView`\n\nUsage of `CompositionView` has been deprecated and will be removed in 21.12.\n\n### Deprecation of path parameter types: `string` and `number`\n\nGoing forward, you should use `str` and `float` for path param types instead of `string` and `number`.\n\n```python\n@app.get(\"//\")\nasync def handler(request, foo: str, bar: float):\n ...\n```\n\nExisting `string` and `number` types are aliased and will continue to work, but will be removed in v21.12.\n\n### Version 0.7 router upgrades\n\nThis includes a number of bug fixes and more gracefully handles a wider array of edge cases than v0.6. If you experience any patterns that are not supported, [please report them](https://github.com/sanic-org/sanic-routing/issues). You can see some of the issues resolved on the `sanic-routing` [release notes](https://github.com/sanic-org/sanic-routing/releases).\n\n### Inline streaming with `eof()`\n\nVersion 21.3 included [big changes in how streaming is handled](https://sanic.dev/en/guide/release-notes/v21.3.html#what-to-know). The pattern introduced will become the default (see below). As a convenience, a new `response.eof()` method has been included. It should be called once the final data has been pushed to the client:\n\n```python\n@app.route(\"/\")\nasync def test(request):\n response = await request.respond(content_type=\"text/csv\")\n await response.send(\"foo,\")\n await response.send(\"bar\")\n await response.eof()\n return response\n```\n\n### New path parameter type: `slug`\n\nYou can now specify a dynamic path segment as a `slug` with appropriate matching:\n\n```python\n@app.get(\"/articles/\")\nasync def article(request, article_slug: str):\n ...\n```\n\nSlugs must consist of lowercase letters or digits. They may contain a hyphen (`-`), but it cannot be the first character.\n\n```\nthis-is-a-slug\nwith-123-is-also-a-slug\n111-at-start-is-a-slug\nNOT-a-slug\n-NOT-a-slug\n```\n\n### Stricter application and blueprint names, and deprecation\n\nYour application and `Blueprint` instances must conform to a stricter set of requirements:\n\n1. Only consisting of alphanumeric characters\n2. May contain a hyphen (`-`) or an underscore (`_`)\n3. Must begin with a letter (uppercase or lowercase)\n\nThe naming convention is similar to Python variable naming conventions, with the addition of allowing hyphens (`-`).\n\nThe looser standard has been deprecatated. Beginning in 21.12, non-conformance will be a startup time error.\n\n### A new access on `Route` object: `route.uri`\n\nThe `Route` object in v21.3 no longer had a `uri` attribute. Instead, the closes you could get was `route.path`. However, because of how `sanic-routing` works, the `path` property does *not* have a leading `/`. This has been corrected so that now there is a `route.uri` with a leading slash:\n\n```python\nroute.uri == f\"/{route.path}\"\n```\n\n### A new accessor on `Request` object impacting IPs\n\nTo access the IP address of the incoming request, Sanic has had a convenience accessor on the request object: `request.ip`. That is not new, and comes from an underlying object that provides details about the open HTTP connection: `request.conn_info`.\n\nThe current version adds a new `client_ip` accessor to that `conn_info` object. For IPv4, you will not notice a difference. However, for IPv6 applications, the new accessor will provide an \"unwrapped\" version of the address. Consider the following example:\n\n```python\n@app.get(\"/\")\nasync def handler(request):\n return json(\n {\n \"request.ip\": request.ip,\n \"request.conn_info.client\": request.conn_info.client,\n \"request.conn_info.client_ip\": request.conn_info.client_ip,\n }\n )\n\napp.run(sock=my_ipv6_sock)\n```\n\n```bash\n$ curl http://\\[::1\\]:8000\n{\n \"request.ip\": \"::1\",\n \"request.conn_info.client\": \"[::1]\",\n \"request.conn_info.client_ip\": \"::1\"\n}\n\n```\n\n### Alternate `Config` and `Sanic.ctx` objects\n\nYou can now pass your own config and context objects to your Sanic applications. A custom configuration *should* be a subclass of `sanic.config.Config`. The context object can be anything you want, with no restrictions whatsoever.\n\n```python\nclass CustomConfig(Config):\n ...\n\nconfig = CustomConfig()\napp = Sanic(\"custom\", config=config)\nassert isinstance(app.config, CustomConfig)\n```\n\nAnd...\n\n```python\nclass CustomContext:\n ...\n\nctx = CustomContext()\napp = Sanic(\"custom\", ctx=ctx)\nassert isinstance(app.ctx, CustomContext)\n```\n\n### Sanic CLI improvements\n\n1. New flag for existing feature: `--auto-reload`\n2. Some new shorthand flags for existing arguments\n3. New feature: `--factory`\n4. New feature: `--simple`\n5. New feature: `--reload-dir`\n\n#### Factory applications\n\nFor applications that follow the factory pattern (a function that returns a `sanic.Sanic` instance), you can now launch your application from the Sanic CLI using the `--factory` flag.\n\n```python\nfrom sanic import Blueprint, Sanic, text\n\nbp = Blueprint(__file__)\n\n@bp.get(\"/\")\nasync def handler(request):\n return text(\"😎\")\n\ndef create_app() -> Sanic:\n app = Sanic(__file__)\n app.blueprint(bp)\n return app\n```\n\nYou can now run it:\n\n```bash\n$ sanic path.to:create_app --factory \n```\n\n#### Sanic Simple Server\n\nSanic CLI now includes a simple pattern to serve a directory as a web server. It will look for an `index.html` at the directory root.\n\n```bash\n$ sanic ./path/to/dir --simple\n```\n\n\n.. warning:: \n\n This feature is still in early *beta* mode. It is likely to change in scope.\n\n\n#### Additional reload directories\n\nWhen using either `debug` or `auto-reload`, you can include additional directories for Sanic to watch for new files.\n\n```bash\nsanic ... --reload-dir=/path/to/foo --reload-dir=/path/to/bar\n```\n\n\n.. tip:: \n\n You do *NOT* need to include this on your application directory. Sanic will automatically reload when any Python file in your application changes. You should use the `reload-dir` argument when you want to listen and update your application when static files are updated.\n\n\n\n### Version prefix\n\nWhen adding `version`, your route is prefixed with `/v`. This will always be at the beginning of the path. This is not new.\n\n```python\n# /v1/my/path\napp.route(\"/my/path\", version=1)\n```\n\nNow, you can alter the prefix (and therefore add path segments *before* the version).\n\n```python\n# /api/v1/my/path\napp.route(\"/my/path\", version=1, version_prefix=\"/api/v\")\n```\n\nThe `version_prefix` argument is can be defined in:\n\n- `app.route` and `bp.route` decorators (and all the convenience decorators also)\n- `Blueprint` instantiation\n- `Blueprint.group` constructor\n- `BlueprintGroup` instantiation\n- `app.blueprint` registration\n\n### Signal event auto-registration\n\nSetting `config.EVENT_AUTOREGISTER` to `True` will allow you to await any signal event even if it has not previously been defined with a signal handler.\n\n```python\n@app.signal(\"do.something.start\")\nasync def signal_handler():\n await do_something()\n await app.dispatch(\"do.something.complete\")\n\n# somethere else in your app:\nawait app.event(\"do.something.complete\")\n```\n\n### Infinitely reusable and nestable `Blueprint` and `BlueprintGroup`\n\nA single `Blueprint` may not be assigned and reused to multiple groups. The groups themselves can also by infinitely nested into one or more other groups. This allows for an unlimited range of composition.\n\n### HTTP methods as `Enum`\n\nSanic now has `sanic.HTTPMethod`, which is an `Enum`. It can be used interchangeably with strings:\n\n```python\nfrom sanic import Sanic, HTTPMethod\n\n@app.route(\"/\", methods=[\"post\", \"PUT\", HTTPMethod.PATCH])\nasync def handler(...):\n ...\n```\n\n### Expansion of `HTTPMethodView`\n\nClass based views may be attached now in one of three ways:\n\n**Option 1 - Existing**\n```python\nclass DummyView(HTTPMethodView):\n ...\n\napp.add_route(DummyView.as_view(), \"/dummy\")\n```\n\n**Option 2 - From `attach` method**\n```python\nclass DummyView(HTTPMethodView):\n ...\n\nDummyView.attach(app, \"/\")\n```\n\n**Option 3 - From class definition at `__init_subclass__`**\n```python\nclass DummyView(HTTPMethodView, attach=app, uri=\"/\"):\n ...\n```\n\nOptions 2 and 3 are useful if your CBV is located in another file:\n\n```python\nfrom sanic import Sanic, HTTPMethodView\n\nclass DummyView(HTTPMethodView, attach=Sanic.get_app(), uri=\"/\"):\n ...\n```\n\n## News\n\n### Discord and support forums\n\nIf you have not already joined our community, you can become a part by joining the [Discord server](https://discord.gg/FARQzAEMAA) and the [Community Forums](https://community.sanicframework.org/). Also, follow [@sanicframework](https://twitter.com/sanicframework) on Twitter.\n\n### SCO 2022 elections\n\nThe Summer 🏝/Winter ❄️ (choose your Hemisphere) is upon us. That means we will be holding elections for the SCO. This year, we will have the following positions to fill:\n\n- Steering Council Member (2 year term)\n- Steering Council Member (2 year term)\n- Steering Council Member (1 year term)\n- Release Manager v22\n- Release Manager v22\n\n[@vltr](https://github.com/vltr) will be staying on to complete his second year on the Steering Council.\n\nIf you are interested in learning more, you can read about the SCO [roles and responsibilities](../../organization/scope.md#roles-and-responsibilities), or Adam Hopkins on Discord.\n\nNominations will begin September 1. More details will be available on the Forums as we get closer.\n\n### New project underway\n\nWe have added a new project to the SCO umbrella: [`sanic-ext`](https://github.com/sanic-org/sanic-ext). It is not yet released, and in heavy active development. The goal for the project will ultimately be to replace [`sanic-openapi`](https://github.com/sanic-org/sanic-openapi) with something that provides more features for web application developers, including input validation, CORS handling, and HTTP auto-method handlers. If you are interested in helping out, let us know on Discord. Look for an initial release of this project sometime (hopefully) before the September release.\n\n## Thank you\n\nThank you to everyone that participated in this release: :clap:\n\n[@aaugustin](https://github.com/aaugustin)\n[@ahopkins](https://github.com/ahopkins)\n[@ajaygupta2790](https://github.com/ajaygupta2790)\n[@ashleysommer](https://github.com/ashleysommer)\n[@ENT8R](https://github.com/ent8r)\n[@fredlllll](https://github.com/fredlllll)\n[@graingert](https://github.com/graingert)\n[@harshanarayana](https://github.com/harshanarayana)\n[@jdraymon](https://github.com/jdraymon)\n[@Kyle-Verhoog](https://github.com/kyle-verhoog)\n[@sanjeevanahilan](https://github.com/sanjeevanahilan)\n[@sjsadowski](https://github.com/sjsadowski)\n[@Tronic](https://github.com/tronic)\n[@vltr](https://github.com/vltr)\n[@ZinkLu](https://github.com/zinklu)\n\n---\n\nIf you enjoy the project, please consider contributing. Of course we love code contributions, but we also love contributions in any form. Consider writing some documentation, showing off use cases, joining conversations and making your voice known, and if you are able, [financial contributions](https://opencollective.com/sanic-org/).\n" }, { "path": "guide/content/en/release-notes/2021/v21.9.md", "content": "---\ntitle: Version 21.9\n---\n\n# Version 21.9\n\n.. toc::\n\n## Introduction\n\nThis is the third release of the version 21 [release cycle](../../organization/policies.md#release-schedule). Version 21 will be \"finalized\" in the December long-term support version release. \n\n## What to know\n\nMore details in the [Changelog](https://sanic.readthedocs.io/en/stable/sanic/changelog.html). Notable new or breaking features, and what to upgrade...\n\n### Removal of config values: `WEBSOCKET_READ_LIMIT`, `WEBSOCKET_WRITE_LIMIT` and `WEBSOCKET_MAX_QUEUE`\n\nWith the complete overhaul of the websocket implementation, these configuration values were removed. There currently is not a plan to replace them.\n\n### Deprecation of default value of `FALLBACK_ERROR_FORMAT`\n\nWhen no error handler is attached, Sanic has used `html` as the fallback format-type. This has been deprecated and will change to `text` starting in v22.3. While the value of this has changed to `auto`, it will still continue to use HTML as the last resort thru v21.12LTS before changing.\n\n### `ErrorHandler.lookup` signature deprecation\n\nThe `ErrorHandler.lookup` now **requires** two positional arguments:\n\n```python\ndef lookup(self, exception, route_name: Optional[str]):\n```\n\nA non-conforming method will cause Blueprint-specific exception handlers to not properly attach.\n\n### Reminder of upcoming removals\n\nAs a reminder, the following items have already been deprecated, and will be removed in version 21.12LTS\n\n- `CompositionView`\n- `load_env` (use `env_prefix` instead)\n- Sanic objects (application instances, blueprints, and routes) must by alphanumeric conforming to: `^[a-zA-Z][a-zA-Z0-9_\\-]*$`\n- Arbitrary assignment of objects to application and blueprint instances (use `ctx` instead; removal of this has been bumped from 21.9 to 21.12)\n\n### Overhaul of websockets\n\nThere has been a huge overhaul to the handling of websocket connections. Thanks to [@aaugustin](https://github.com/aaugustin) the [`websockets`](https://websockets.readthedocs.io/en/stable/index.html) now has a new implementation that allows Sanic to handle the I/O of websocket connections on its own. Therefore, Sanic has bumped the minimum version to `websockets>=10.0`.\n\nThe change should mostly be unnoticeable to developers, except that some of the oddities around websocket handlers in Sanic have been corrected. For example, you now should be able to catch the `CancellError` yourself when someone disconnects:\n\n```python\n@app.websocket(\"/\")\nasync def handler(request, ws):\n try:\n while True:\n await asyncio.sleep(0.25)\n except asyncio.CancelledError:\n print(\"User closed connection\")\n```\n\n### Built-in signals\n\nVersion [21.3](./v21.3.md) introduced [signals](../../guide/advanced/signals.md). Now, Sanic dispatches signal events **from within the codebase** itself. This means that developers now have the ability to hook into the request/response cycle at a much closer level than before.\n\nPreviously, if you wanted to inject some logic you were limited to middleware. Think of integrated signals as _super_-middleware. The events that are dispatched now include:\n\n- `http.lifecycle.begin`\n- `http.lifecycle.complete`\n- `http.lifecycle.exception`\n- `http.lifecycle.handle`\n- `http.lifecycle.read_body`\n- `http.lifecycle.read_head`\n- `http.lifecycle.request`\n- `http.lifecycle.response`\n- `http.lifecycle.send`\n- `http.middleware.after`\n- `http.middleware.before`\n- `http.routing.after`\n- `http.routing.before`\n- `server.init.after`\n- `server.init.before`\n- `server.shutdown.after`\n- `server.shutdown.before`\n\n\n.. note::\n\n The `server` signals are the same as the four (4) main server listener events. In fact, those listeners themselves are now just convenience wrappers to signal implementations.\n\n\n### Smarter `auto` exception formatting\n\nSanic will now try to respond with an appropriate exception format based upon the endpoint and the client. For example, if your endpoint always returns a `sanic.response.json` object, then any exceptions will automatically be formatted in JSON. The same is true for `text` and `html` responses.\n\nFurthermore, you now can _explicitly_ control which formatter to use on a route-by-route basis using the route definition:\n\n```python\n@app.route(\"/\", error_format=\"json\")\nasync def handler(request):\n pass\n```\n\n### Blueprint copying\n\nBlueprints can be copied to new instances. This will carry forward everything attached to it, like routes, middleware, etc.\n\n```python\nv1 = Blueprint(\"Version1\", version=1)\n\n@v1.route(\"/something\")\ndef something(request):\n pass\n\nv2 = v1.copy(\"Version2\", version=2)\n\napp.blueprint(v1)\napp.blueprint(v2)\n```\n\n```\n/v1/something\n/v2/something\n```\n### Blueprint group convenience methods\n\nBlueprint groups should now have all of the same methods available to them as regular Blueprints. With this, along with Blueprint copying, Blueprints should now be very composable and flexible.\n\n### Accept header parsing\n\nSanic `Request` objects can parse an `Accept` header to provide an ordered list of the client's content-type preference. You can simply access it as an accessor:\n\n```python\nprint(request.accept)\n# [\"*/*\"]\n```\n\nIt also is capable of handling wildcard matching. For example, assuming the incoming request included:\n\n```\nAccept: */*\n```\n\nThen, the following is `True`:\n\n```python\n\"text/plain\" in request.accept\n```\n\n### Default exception messages\n\nAny exception that derives from `SanicException` can now define a default exception message. This makes it more convenient and maintainable to reuse the same exception in multiple places without running into DRY issues with the message that the exception provides.\n\n```python\nclass TeaError(SanicException):\n message = \"Tempest in a teapot\"\n\nraise TeaError\n```\n\n### Type annotation conveniences\n\nIt is now possible to control the path parameter types using Python's type annotations. Instead of doing this:\n\n```python\n@app.route(\"///\")\ndef handler(request: Request, one: int, two: float, three: UUID):\n ...\n```\n\nYou can now simply do this:\n\n```python\n@app.route(\"///\")\ndef handler(request: Request, one: int, two: float, three: UUID):\n ...\n```\n\nBoth of these examples will result in the same routing principles to be applied.\n\n### Explicit static resource type\n\nYou can now explicitly tell a `static` endpoint whether it is supposed to treat the resource as a file or a directory:\n\n```python\nstatic(\"/\", \"/path/to/some/file\", resource_type=\"file\"))\n```\n\n## News\n\n### Release of `sanic-ext` and deprecation of `sanic-openapi`\n\nOne of the core principles of Sanic is that it is meant to be a tool, not a dictator. As the frontpage of this website states:\n\n> Build the way you want to build without letting your tooling constrain you.\n\nThis means that a lot of common features used (specifically by Web API developers) do not exist in the `sanic` repository. This is for good reason. Being unopinionated provides the developer freedom and flexibility.\n\nBut, sometimes you do not want to have to build and rebuild the same things. Sanic has until now really relied upon the awesome support of the community to fill in the gaps with plugins.\n\nFrom the early days, there has been an official `sanic-openapi` package that offered the ability to create OpenAPI documentation based upon your application. But, that project has been plagued over the years and has not been given as much priority as the main project.\n\nStarting with the release of v21.9, the SCO is deprecating the `sanic-openapi` package and moving it to maintenance mode. This means that it will continue to get updates as needed to maintain it for the current future, but it will not receive any new feature enhancements.\n\nA new project called `sanic-ext` is taking its place. This package provides not only the ability to build OAS3 documentation, but fills in many of the gaps that API developers may want in their applications. For example, out of the box it will setup CORS, and auto enable `HEAD` and `OPTIONS` responses where needed. It also has the ability validate incoming data using either standard library Dataclasses or Pydantic models.\n\nThe list of goodies includes:\n- CORS protection\n- incoming request validation\n- auto OAS3 documentation using Redoc and/or Swagger UI\n- auto `HEAD`, `OPTIONS`, and `TRACE` responses\n- dependency injection\n- response serialization\n\nThis project is still in `alpha` mode for now and is subject to change. While it is considered to be production capable, there may be some need to change the API as we continue to add features.\n\nCheckout the [documentation](../../plugins/sanic-ext/getting-started.md) for more details.\n\n## Thank you\n\nThank you to everyone that participated in this release: :clap:\n\n[@aaugustin](https://github.com/aaugustin)\n[@ahopkins](https://github.com/ahopkins)\n[@ashleysommer](https://github.com/ashleysommer)\n[@cansarigol3megawatt](https://github.com/cansarigol3megawatt)\n[@ChihweiLHBird](https://github.com/ChihweiLHBird)\n[@gluhar2006](https://github.com/gluhar2006)\n[@komar007](https://github.com/komar007)\n[@ombe1229](https://github.com/ombe1229)\n[@prryplatypus](https://github.com/prryplatypus)\n[@SaidBySolo](https://github.com/SaidBySolo)\n[@Tronic](https://github.com/tronic)\n[@vltr](https://github.com/vltr)\n\nAnd, a special thank you to [@miss85246](https://github.com/miss85246) and [@ZinkLu](https://github.com/ZinkLu) for their tremendous work keeping the documentation synced and translated into Chinese.\n\n---\n\nIf you enjoy the project, please consider contributing. Of course we love code contributions, but we also love contributions in any form. Consider writing some documentation, showing off use cases, joining conversations and making your voice known, and if you are able, [financial contributions](https://opencollective.com/sanic-org/).\n" }, { "path": "guide/content/en/release-notes/2022/v22.12.md", "content": "---\ntitle: Version 22.12 (LTS)\n---\n\n# Version 22.12 (LTS)\n\n.. toc::\n\n## Introduction\n\nThis is the final release of the version 22 [release cycle](../../organization/policies.md#release-schedule). As such it is a **long-term support** release, and will be supported as stated in the [policies](../../org/policies.md#long-term-support-v-interim-releases).\n\n## What to know\n\nMore details in the [Changelog](https://sanic.readthedocs.io/en/stable/sanic/changelog.html). Notable new or breaking features, and what to upgrade...\n\n### 🚨 *BREAKING CHANGE* - Sanic Inspector is now an HTTP server\n\nSanic v22.9 introduced the [Inspector](./v22.9.md#inspector) to allow live inspection of a running Sanic instance. This feature relied upon opening a TCP socket and communicating over a custom protocol. That basic TCP protocol has been dropped in favor of running a full HTTP service in its place. [Learn more about the Inspector](../deployment/inspector.md).\n\nThe current release introduces a new HTTP server and a refreshed CLI experience. This enables several new features highlighted here. Perhaps the most significant change, however, is to move all of the Inspector's commands to a subparser on the CLI instance.\n\n```\n$ sanic inspect --help \n\n ▄███ █████ ██ ▄█▄ ██ █ █ ▄██████████\n ██ █ █ █ ██ █ █ ██\n ▀███████ ███▄ ▀ █ █ ██ ▄ █ ██\n ██ █████████ █ ██ █ █ ▄▄\n ████ ████████▀ █ █ █ ██ █ ▀██ ███████\n\nOptional\n========\n General:\n -h, --help show this help message and exit\n --host HOST, -H HOST Inspector host address [default 127.0.0.1]\n --port PORT, -p PORT Inspector port [default 6457]\n --secure, -s Whether to access the Inspector via TLS encryption\n --api-key API_KEY, -k API_KEY Inspector authentication key\n --raw Whether to output the raw response information\n\n Subcommands:\n Run one or none of the below subcommands. Using inspect without a subcommand will fetch general information about the state of the application instance.\n \n Or, you can optionally follow inspect with a subcommand. If you have created a custom Inspector instance, then you can run custom commands. See https://sanic.dev/en/guide/deployment/inspector.html for more details.\n\n {reload,shutdown,scale,}\n reload Trigger a reload of the server workers\n shutdown Shutdown the application and all processes\n scale Scale the number of workers\n Run a custom command\n```\n\n#### CLI remote access now available\n\nThe `host` and `port` of the Inspector are now explicitly exposed on the CLI as shown above. Previously in v22.9, they were inferred by reference to the application instance. Because of this change, it will be more possible to expose the Inspector on live production instances and access from a remote installation of the CLI. \n\nFor example, you can check your running production deployment from your local development machine.\n\n```\n$ sanic inspect --host=1.2.3.4\n```\n\n\n.. warning:: \n\n For **production** instances, make sure you are _using TLS and authentication_ described below.\n\n#### TLS encryption now available\n\nYou can secure your remote Inspector access by providing a TLS certificate to encrypt the web traffic.\n\n```python\napp.config.INSPECTOR_TLS_CERT = \"/path/to/cert.pem\"\napp.config.INSPECTOR_TLS_KEY = \"/path/to/key.pem\"\n```\n\nTo access an encrypted installation via the CLI, use the `--secure` flag.\n\n```\n$ sanic inspect --secure\n```\n\n#### Authentication now available\n\nTo control access to the remote Inspector, you can protect the endpoints using an API key.\n\n```python\napp.config.INSPECTOR_API_KEY = \"Super-Secret-200\"\n```\n\nTo access a protected installation via the CLI, use the `--api-key` flag.\n\n```\n$ sanic inspect --api-key=Super-Secret-200\n```\n\nThis is equivalent to the header: `Authorization: Bearer `.\n\n```\n$ curl http://localhost:6457 -H \"Authorization: Bearer Super-Secret-200\"\n```\n\n### Scale number of running server workers\n\nThe Inspector is now capable of scaling the number of worker processes. For example, to scale to 3 replicas, use the following command:\n\n```\n$ sanic inspect scale 3\n```\n\n### Extend Inspector with custom commands\n\nThe Inspector is now fully extendable to allow for adding custom commands to the CLI. For more information see [Custom Commands](../deployment/inspector.md#custom-commands).\n\n```\n$ sanic inspect foo --bar\n```\n\n### Early worker exit on failure\n\nThe process manager shipped with v22.9 had a very short startup timeout. This was to protect against deadlock. This was increased to 30s, and a new mechanism has been added to fail early if there is a crash in a worker process on startup.\n\n### Introduce `JSONResponse` with convenience methods to update a JSON response body\n\nThe `sanic.response.json` convenience method now returns a new subclass of `HTTPResponse` appropriately named: `JSONResponse`. This new type has some convenient methods for handling changes to a response body after its creation.\n\n```python\nresp = json({\"foo\": \"bar\"})\nresp.update({\"another\": \"value\"})\n```\n\nSee [Returning JSON Data](../basics/response.md#returning-json-data) for more information.\n\n### Updates to downstream requirements: `uvloop` and `websockets`\n\nMinimum `uvloop` was set to `0.15.0`. Changes were added to make Sanic compliant with `websockets` version `11.0`.\n\n### Force exit on 2nd `ctrl+c`\n\nOn supporting operating systems, the existing behavior is for Sanic server to try to perform a graceful shutdown when hitting `ctrl+c`. This new release will perform an immediate shutdown on subsequent `ctrl+c` after the initial shutdown has begun.\n\n### Deprecations and Removals\n\n1. *DEPRECATED* - The `--inspect*` commands introduced in v22.9 have been replaced with a new subcommand parser available as `inspect`. The flag versions will continue to operate until v23.3. You are encouraged to use the replacements. While this short deprecation period is a deviation from the standard two-cycles, we hope this change will be minimally disruptive.\n ```\n OLD sanic ... --inspect\n NEW sanic ... inspect\n \n OLD sanic ... --inspect-raw\n NEW sanic ... inspect --raw\n \n OLD sanic ... --inspect-reload\n NEW sanic ... inspect reload\n \n OLD sanic ... --inspect-shutdown\n NEW sanic ... inspect shutdown\n ```\n\n## News\n\nThe Sanic Community Organization will be headed by a new Steering Council for 2023. There are two returning and two new members. \n\n[@ahopkins](https://github.com/ahopkins) *returning* \\\n[@prryplatypus](https://github.com/prryplatypus) *returning* \\\n[@sjsadowski](https://github.com/sjsadowski) *NEW* \\\n[@Tronic](https://github.com/Tronic) *NEW*\n\nThe 2023 release managers are [@ahopkins](https://github.com/ahopkins) and [@sjsadowski](https://github.com/sjsadowski).\n\nIf you are interested in getting more involved with Sanic, contact us on the [Discord server](https://discord.gg/FARQzAEMAA).\n\n## Thank you\n\nThank you to everyone that participated in this release: :clap:\n\n[@aaugustin](https://github.com/aaugustin)\n[@ahopkins](https://github.com/ahopkins)\n[@ChihweiLHBird](https://github.com/ChihweiLHBird)\n[@kijk2869](https://github.com/kijk2869)\n[@LiraNuna](https://github.com/LiraNuna)\n[@prryplatypus](https://github.com/prryplatypus)\n[@sjsadowski](https://github.com/sjsadowski)\n[@todddialpad](https://github.com/todddialpad)\n[@Tronic](https://github.com/Tronic)\n\n---\n\nIf you enjoy the project, please consider contributing. Of course we love code contributions, but we also love contributions in any form. Consider writing some documentation, showing off use cases, joining conversations and making your voice known, and if you are able: [financial contributions](https://opencollective.com/sanic-org/).\n" }, { "path": "guide/content/en/release-notes/2022/v22.3.md", "content": "---\ntitle: Version 22.3\n---\n\n# Version 22.3\n\n.. toc::\n\n## Introduction\n\nThis is the first release of the version 22 [release cycle](../../organization/policies.md#release-schedule). All of the standard SCO libraries are now entering the same release cycle and will follow the same versioning pattern. Those packages are:\n\n- [`sanic-routing`](https://github.com/sanic-org/sanic-routing)\n- [`sanic-testing`](https://github.com/sanic-org/sanic-testing)\n- [`sanic-ext`](https://github.com/sanic-org/sanic-ext)\n\n## What to know\n\nMore details in the [Changelog](https://sanic.readthedocs.io/en/stable/sanic/changelog.html). Notable new or breaking features, and what to upgrade...\n\n### Application multi-serve\n\nThe Sanic server now has an API to allow you to run multiple applications side-by-side in the same process. This is done by calling `app.prepare(...)` on one or more application instances, one or many times. Each time it should be bound to a unique host/port combination. Then, you begin serving the applications by calling `Sanic.serve()`.\n\n```python\napp = Sanic(\"One\")\napp2 = Sanic(\"Two\")\n\napp.prepare(port=9999)\napp.prepare(port=9998)\napp.prepare(port=9997)\napp2.prepare(port=8888)\napp2.prepare(port=8887)\n\nSanic.serve()\n```\n\nIn the above snippet, there are two applications that will be run concurrently and bound to multiple ports. This feature is *not* supported in the CLI.\n\nThis pattern is meant to be an alternative to running `app.run(...)`. It should be noted that `app.run` is now just a shorthand for the above pattern and is still fully supported.\n\n### 👶 *BETA FEATURE* - New path parameter type: file extensions\n\nA very common pattern is to create a route that dynamically generates a file. The endpoint is meant to match on a file with an extension. There is a new path parameter to match files: ``.\n\n```python\n@app.get(\"/path/to/\")\nasync def handler(request, filename, ext):\n ...\n```\n\nThis will catch any pattern that ends with a file extension. You may, however want to expand this by specifying which extensions, and also by using other path parameter types for the file name. \n\nFor example, if you want to catch a `.jpg` file that is only numbers:\n\n```python\n@app.get(\"/path/to/\")\nasync def handler(request, filename, ext):\n ...\n```\n\nSome potential examples:\n\n| definition | example | filename | extension |\n| --------------------------------- | ----------- | ----------- | ---------- |\n| \\ | page.txt | `\"page\"` | `\"txt\"` |\n| \\ | cat.jpg | `\"cat\"` | `\"jpg\"` |\n| \\ | cat.jpg | `\"cat\"` | `\"jpg\"` |\n| | 123.txt | `123` | `\"txt\"` |\n| | 123.svg | `123` | `\"svg\"` |\n| | 3.14.tar.gz | `3.14` | `\"tar.gz\"` | \n\n### 🚨 *BREAKING CHANGE* - Path parameter matching of non-empty strings\n\nA dynamic path parameter will only match on a non-empty string. \n\nPreviously a route with a dynamic string parameter (`/` or `/`) would match on any string, including empty strings. It will now only match a non-empty string. To retain the old behavior, you should use the new parameter type: `/`.\n\n```python\n@app.get(\"/path/to/\")\nasync def handler(request, foo)\n ...\n```\n\n### 🚨 *BREAKING CHANGE* - `sanic.worker.GunicornWorker` has been removed\n\nDeparting from our normal deprecation policy, the `GunicornWorker` was removed as a part of the process of upgrading the Sanic server to include multi-serve. This decision was made largely in part because even while it existed it was not an optimal strategy for deploying Sanic.\n\nIf you want to deploy Sanic using `gunicorn`, then you are advised to do it using [the strategy implemented by `uvicorn`](https://www.uvicorn.org/#running-with-gunicorn). This will effectively run Sanic as an ASGI application through `uvicorn`. You can upgrade to this pattern by installing `uvicorn`:\n\n```\npip install uvicorn\n```\n\nThen, you should be able to run it with a pattern like this:\n\n```\ngunicorn path.to.sanic:app -k uvicorn.workers.UvicornWorker\n```\n\n### Authorization header parsing\n\nThe `Authorization` header has been partially parseable for some time now. You have been able to use `request.token` to gain access to a header that was in one of the following two forms:\n\n```\nAuthorization: Token \nAuthorization: Bearer \n```\n\nSanic can now parse more credential types like `BASIC`:\n\n```\nAuthorization: Basic Z2lsLWJhdGVzOnBhc3N3b3JkMTIz\n```\n\nThis can be accessed now as `request.credentials`:\n\n```python\nprint(request.credentials)\n# Credentials(auth_type='Basic', token='Z2lsLWJhdGVzOnBhc3N3b3JkMTIz', _username='gil-bates', _password='password123')\n```\n\n### CLI arguments optionally injected into application factory\n\nSanic will now attempt to inject the parsed CLI arguments into your factory if you are using one.\n\n```python\ndef create_app(args):\n app = Sanic(\"MyApp\")\n print(args)\n return app\n```\n```\n$sanic p:create_app --factory\nNamespace(module='p:create_app', factory=True, simple=False, host='127.0.0.1', port=8000, unix='', cert=None, key=None, tls=None, tlshost=False, workers=1, fast=False, access_log=False, debug=False, auto_reload=False, path=None, dev=False, motd=True, verbosity=None, noisy_exceptions=False)\n```\n\nIf you are running the CLI with `--factory`, you also have the option of passing arbitrary arguments to the command, which will be injected into the argument `Namespace`.\n\n```\nsanic p:create_app --factory --foo=bar\nNamespace(module='p:create_app', factory=True, simple=False, host='127.0.0.1', port=8000, unix='', cert=None, key=None, tls=None, tlshost=False, workers=1, fast=False, access_log=False, debug=False, auto_reload=False, path=None, dev=False, motd=True, verbosity=None, noisy_exceptions=False, foo='bar')\n```\n\n### New reloader process listener events\n\nWhen running Sanic server with auto-reload, there are two new events that trigger a listener *only* on the reloader process:\n\n- `reload_process_start`\n- `reload_process_stop`\n\nThese are only triggered if the reloader is running.\n\n```python\n@app.reload_process_start\nasync def reload_start(*_):\n print(\">>>>>> reload_start <<<<<<\")\n\n@app.reload_process_stop\nasync def reload_stop(*_):\n print(\">>>>>> reload_stop <<<<<<\")\n```\n\n### The event loop is no longer a required argument of a listener\n\nYou can leave out the `loop` argument of a listener. Both of these examples work as expected:\n\n```python\n@app.before_server_start\nasync def without(app):\n ...\n\n@app.before_server_start\nasync def with(app, loop):\n ...\n```\n\n### Removal - Debug mode does not automatically start the reloader\n\nWhen running with `--debug` or `debug=True`, the Sanic server will not automatically start the auto-reloader. This feature of doing both on debug was deprecated in v21 and removed in this release. If you would like to have *both* debug mode and auto-reload, you can use `--dev` or `dev=True`.\n\n**dev = debug mode + auto reloader**\n\n### Deprecation - Loading of lower case environment variables\n\nSanic loads prefixed environment variables as configuration values. It has not distinguished between uppercase and lowercase as long as the prefix matches. However, it has always been the convention that the keys should be uppercase. This is deprecated and you will receive a warning if the value is not uppercase. In v22.9 only uppercase and prefixed keys will be loaded.\n\n## News\n\n### Packt publishes new book on Sanic web development\n\n.. column::\n\n There is a new book on **Python Web Development with Sanic** by [@ahopkins](https://github.com/ahopkins). The book is endorsed by the SCO and part of the proceeds of all sales go directly to the SCO for further development of Sanic.\n\n You can learn more at [sanicbook.com](https://sanicbook.com/)\n\n.. column::\n\n ![Python Web Development with Sanic](https://sanicbook.com/images/SanicCoverFinal.png)\n\n## Thank you\n\nThank you to everyone that participated in this release: :clap:\n\n[@aericson](https://github.com/aericson)\n[@ahankinson](https://github.com/ahankinson)\n[@ahopkins](https://github.com/ahopkins)\n[@ariebovenberg](https://github.com/ariebovenberg)\n[@ashleysommer](https://github.com/ashleysommer)\n[@Bluenix2](https://github.com/Bluenix2)\n[@ChihweiLHBird](https://github.com/ChihweiLHBird)\n[@dotlambda](https://github.com/dotlambda)\n[@eric-spitler](https://github.com/eric-spitler)\n[@howzitcdf](https://github.com/howzitcdf)\n[@jonra1993](https://github.com/jonra1993)\n[@prryplatypus](https://github.com/prryplatypus)\n[@raphaelauv](https://github.com/raphaelauv)\n[@SaidBySolo](https://github.com/SaidBySolo)\n[@SerGeRybakov](https://github.com/SerGeRybakov)\n[@Tronic](https://github.com/Tronic)\n\n---\n\nIf you enjoy the project, please consider contributing. Of course we love code contributions, but we also love contributions in any form. Consider writing some documentation, showing off use cases, joining conversations and making your voice known, and if you are able: [financial contributions](https://opencollective.com/sanic-org/).\n" }, { "path": "guide/content/en/release-notes/2022/v22.6.md", "content": "---\ntitle: Version 22.6\n---\n\n# Version 22.6\n\n.. toc::\n\n## Introduction\n\nThis is the second release of the version 22 [release cycle](../../organization/policies.md#release-schedule). Version 22 will be \"finalized\" in the December long-term support version release. \n\n## What to know\n\nMore details in the [Changelog](https://sanic.readthedocs.io/en/stable/sanic/changelog.html). Notable new or breaking features, and what to upgrade...\n\n### Automatic TLS setup in `DEBUG` mode\n\nThe Sanic server can automatically setup a TLS certificate using either [mkcert](https://github.com/FiloSottile/mkcert) or [trustme](https://github.com/python-trio/trustme). This certificate will enable `https://localhost` (or another local address) for local development environments. You must install either `mkcert` or `trustme` on your own for this to work.\n\n.. column::\n\n ```\n $ sanic path.to.server:app --auto-tls --debug\n ```\n\n.. column::\n\n ```python\n app.run(debug=True, auto_tls=True)\n ```\n\nThis feature is not available when running in `ASGI` mode, or in `PRODUCTION` mode. When running Sanic in production, you should be using a real TLS certificate either purchased through a legitimate vendor, or using [Let's Encrypt](https://letsencrypt.org/).\n\n### HTTP/3 Server 🚀\n\nIn June 2022, the IETF finalized and published [RFC 9114](https://www.rfc-editor.org/rfc/rfc9114.html), the specification for HTTP/3. In short, HTTP/3 is a **very** different protocol than HTTP/1.1 and HTTP/2 because it implements HTTP over UDP instead of TCP. The new HTTP protocol promises faster webpage load times and solving some of the problems of the older standards. You are encouraged to [read more about](https://http3-explained.haxx.se/) this new web technology. You likely will need to install a [capable client](https://curl.se/docs/http3.html) as traditional tooling will not work.\n\nSanic server offers HTTP/3 support using [aioquic](https://github.com/aiortc/aioquic). This **must** be installed:\n\n```\npip install sanic aioquic\n```\n\n```\npip install sanic[http3]\n```\n\nTo start HTTP/3, you must explicitly request it when running your application.\n\n.. column::\n\n ```\n $ sanic path.to.server:app --http=3\n ```\n\n ```\n $ sanic path.to.server:app -3\n ```\n\n.. column::\n\n ```python\n app.run(version=3)\n ```\n\nTo run both an HTTP/3 and HTTP/1.1 server simultaneously, you can use [application multi-serve](./v22.3.html#application-multi-serve) introduced in v22.3.\n\n\n.. column::\n\n ```\n $ sanic path.to.server:app --http=3 --http=1\n ```\n\n ```\n $ sanic path.to.server:app -3 -1\n ```\n\n.. column::\n\n ```python\n app.prepre(version=3)\n app.prepre(version=1)\n Sanic.serve()\n ```\n\nBecause HTTP/3 requires TLS, you cannot start a HTTP/3 server without a TLS certificate. You should [set it up yourself](../../guide/how-to/tls.md) or use `mkcert` if in `DEBUG` mode. Currently, automatic TLS setup for HTTP/3 is not compatible with `trustme`.\n\n**👶 This feature is being released as an *EARLY RELEASE FEATURE*.** It is **not** yet fully compliant with the HTTP/3 specification, lacking some features like [websockets](https://websockets.spec.whatwg.org/), [webtransport](https://w3c.github.io/webtransport/), and [push responses](https://http3-explained.haxx.se/en/h3/h3-push). Instead the intent of this release is to bring the existing HTTP request/response cycle towards feature parity with HTTP/3. Over the next several releases, more HTTP/3 features will be added and the API for it finalized.\n\n### Consistent exception naming\n\nSome of the Sanic exceptions have been renamed to be more compliant with standard HTTP response names.\n\n- `InvalidUsage` >> `BadRequest`\n- `MethodNotSupported` >> `MethodNotAllowed`\n- `ContentRangeError` >> `RangeNotSatisfiable`\n\nAll old names have been aliased and will remain backwards compatible.\n\n### Current request getter\n\nSimilar to the API to access an application (`Sanic.get_app()`), there is a new method for retrieving the current request when outside of a request handler.\n\n```python\nfrom sanic import Request\n\nRequest.get_current()\n```\n\n### Improved API support for setting cache control headers\n\nThe `file` response helper has some added parameters to make it easier to handle setting of the [Cache-Control](https://developer.mozilla.org/en-US/docs/Web/HTTP/Headers/Cache-Control) header.\n\n```python\nfile(\n ...,\n last_modified=...,\n max_age=...,\n no_store=...,\n)\n```\n\n### Custom `loads` function\n\nJust like Sanic supports globally setting a custom `dumps`, you can now set a global custom `loads`.\n\n```python\nfrom orjson import loads\n\napp = Sanic(\"Test\", loads=loads)\n```\n\n### Deprecations and Removals\n\n1. *REMOVED* - Applications may no longer opt-out of the application registry\n1. *REMOVED* - Custom exception handlers will no longer run after some part of an exception has been sent\n1. *REMOVED* - Fallback error formats cannot be set on the `ErrorHandler` and must **only** be set in the `Config`\n1. *REMOVED* - Setting a custom `LOGO` for startup is no longer allowed\n1. *REMOVED* - The old `stream` response convenience method has been removed\n1. *REMOVED* - `AsyncServer.init` is removed and no longer an alias of `AsyncServer.app.state.is_started`\n\n\n## Thank you\n\nThank you to everyone that participated in this release: :clap:\n\n[@ahopkins](https://github.com/ahopkins)\n[@amitay87](https://github.com/amitay87 )\n[@ashleysommer](https://github.com/ashleysommer)\n[@azimovMichael](https://github.com/azimovMichael)\n[@ChihweiLHBird](https://github.com/ChihweiLHBird)\n[@kijk2869](https://github.com/kijk2869)\n[@prryplatypus](https://github.com/prryplatypus)\n[@SaidBySolo](https://github.com/SaidBySolo)\n[@sjsadowski](https://github.com/sjsadowski)\n[@timmo001](https://github.com/timmo001)\n[@zozzz](https://github.com/zozzz)\n\n---\n\nIf you enjoy the project, please consider contributing. Of course we love code contributions, but we also love contributions in any form. Consider writing some documentation, showing off use cases, joining conversations and making your voice known, and if you are able: [financial contributions](https://opencollective.com/sanic-org/).\n" }, { "path": "guide/content/en/release-notes/2022/v22.9.md", "content": "---\ntitle: Version 22.9\n---\n\n# Version 22.9\n\n.. toc::\n\n## Introduction\n\nThis is the third release of the version 22 [release cycle](../../organization/policies.md#release-schedule). Version 22 will be \"finalized\" in the December long-term support version release. \n\n## What to know\n\nMore details in the [Changelog](https://sanic.readthedocs.io/en/stable/sanic/changelog.html). Notable new or breaking features, and what to upgrade...\n\n### ⚠ *IMPORTANT* - New worker manager 🚀\n\nSanic server has been overhauled to provide more consistency and flexbility in how it operates. More details about the motivations are outlined in [PR #2499](https://github.com/sanic-org/sanic/pull/2499) and discussed in a live stream [discussion held on YouTube](https://youtu.be/m8HCO8NK7HE).\n\nThis **does NOT apply** to Sanic in ASGI mode\n\n#### Overview of the changes\n\n- The worker servers will **always** run in a child process.\n - Previously this could change depending upon one versus many workers, and the usage or not of the reloader. This should lead to much more predictable development environments that more closely match their production counterparts.\n- Multi-workers is **now supported on Windows**.\n - This was impossible because Sanic relied upon the `multiprocessing` module using `fork`, which is not available on Windows.\n - Now, Sanic will always use `spawn`. This does have some noticeable differences, particularly if you are running Sanic in the global scope with `app.run` (see below re: upgrade issues).\n- The application instance now has a new `multiplexer` object that can be used to restart one or many workers. This could, for example, be triggered by a request.\n- There is a new Inspector that can provide details on the state of your server.\n- Sanic worker manager can run arbitrary processes.\n - This allows developers to add any process they want from within Sanic.\n - Possible use cases:\n - Health monitor, see [Sanic Extensions]()\n - Logging queue, see [Sanic Extensions]()\n - Background worker queue in a seperate process\n - Running another application, like a bot\n- There is a new listener called: `main_process_ready`. It really should only be used for adding arbitrary processes to Sanic.\n- Passing shared objects between workers.\n - Python does allow some types of objects to share state between processes, whether through shared memory, pipes, etc.\n - Sanic will now allow these types of object to be shared on the `app.shared_ctx` object.\n - Since this feature relies upon Pythons `multiprocessing` library, it obviously will only work to share state between Sanic worker instances that are instantiated from the same execution. This is *not* meant to provide an API for horizontal scaling across multiple machines for example.\n\n#### Adding a shared context object\n\nTo share an object between worker processes, it *MUST* be assigned inside of the `main_process_start` listener.\n\n```python\nfrom multiprocessing import Queue\n\n@app.main_process_start\nasync def main_process_start(app):\n app.shared_ctx.queue = Queue()\n```\n\nAll objects on `shared_ctx` will be available now within each worker process. \n\n```python\n@app.before_server_starts\nasync def before_server_starts(app):\n assert isinstance(app.shared_ctx.queue, Queue)\n\n@app.on_request\nasync def on_request(request):\n assert isinstance(request.app.shared_ctx.queue, Queue)\n\n@app.get(\"/\")\nasync def handler(request):\n assert isinstance(request.app.shared_ctx.queue, Queue)\n```\n\n*NOTE: Sanic will not stop you from registering an unsafe object, but may warn you. Be careful not to just add a regular list object, for example, and expect it to work. You should have an understanding of how to share state between processes.*\n\n#### Running arbitrary processes\n\nSanic can run any arbitrary process for you. It should be capable of being stopped by a `SIGINT` or `SIGTERM` OS signal.\n\nThese processes should be registered inside of the `main_process_ready` listener.\n\n```python\n@app.main_process_ready\nasync def ready(app: Sanic, _):\n app.manager.manage(\"MyProcess\", my_process, {\"foo\": \"bar\"})\n# app.manager.manage(, , )\n```\n\n#### Inspector\n\nSanic ships with an optional Inspector, which is a special process that allows for the CLI to inspect the running state of an application and issue commands. It currently will only work if the CLI is being run on the same machine as the Sanic instance.\n\n```\nsanic path.to:app --inspect\n```\n\n![Sanic inspector](https://user-images.githubusercontent.com/166269/190099384-2f2f3fae-22d5-4529-b279-8446f6b5f9bd.png)\n\nThe new CLI commands are:\n\n```\n --inspect Inspect the state of a running instance, human readable\n --inspect-raw Inspect the state of a running instance, JSON output\n --trigger-reload Trigger worker processes to reload\n --trigger-shutdown Trigger all processes to shutdown\n```\n\nThis is not enabled by default. In order to have it available, you must opt in:\n\n```python\napp.config.INSPECTOR = True\n```\n\n*Note: [Sanic Extensions]() provides a [custom request](../../guide/basics/app.md#custom-requests) class that will add a request counter to the server state.\n\n#### Application multiplexer\n\nMany of the same information and functionality is available on the application instance itself. There is a new `multiplexer` object on the application instance that has the ability to restart one or more workers, and fetch information about the current state.\n\nYou can access it as `app.multiplexer`, or more likely by its short alias `app.m`.\n\n```python\n@app.on_request\nasync def print_state(request: Request):\n print(request.app.m.state)\n```\n\n#### Potential upgrade issues\n\nBecause of the switch from `fork` to `spawn`, if you try running the server in the global scope you will receive an error. If you see something like this:\n\n```\nsanic.exceptions.ServerError: Sanic server could not start: [Errno 98] Address already in use.\nThis may have happened if you are running Sanic in the global scope and not inside of a `if __name__ == \"__main__\"` block.\n```\n\n... then the change is simple. Make sure `app.run` is inside a block.\n\n```python\nif __name__ == \"__main__\":\n app.run(port=9999, dev=True)\n```\n\n#### Opting out of the new functionality\n\nIf you would like to run Sanic without the new process manager, you may easily use the legacy runners. Please note that support for them **will be removed** in the future. A date has not yet been set, but will likely be sometime in 2023.\n\nTo opt out of the new server and use the legacy, choose the appropriate method depending upon how you run Sanic:\n\n.. column::\n\n If you use the CLI...\n\n.. column::\n\n ```\n sanic path.to:app --legacy\n ```\n\n\n.. column::\n\n If you use `app.run`...\n\n.. column::\n\n ```\n app.run(..., legacy=True)\n ```\n\n\n.. column::\n\n If you `app.prepare`...\n\n.. column::\n\n ```\n app.prepare(...)\n Sanic.serve_legacy()\n ```\n\nSimilarly, you can force Sanic to run in a single process. This however means there will not be any access to the auto-reloader.\n\n.. column::\n\n If you use the CLI...\n\n.. column::\n\n ```\n sanic path.to:app --single-process\n ```\n\n\n.. column::\n\n If you use `app.run`...\n\n.. column::\n\n ```\n app.run(..., single_process=True)\n ```\n\n\n.. column::\n\n If you `app.prepare`...\n\n.. column::\n\n ```\n app.prepare(...)\n Sanic.serve_single()\n ```\n\n### Middleware priority\n\nMiddleware is executed in an order based upon when it was defined. Request middleware are executed in sequence and response middleware in reverse. This could have an unfortunate impact if your ordering is strictly based upon import ordering with global variables for example.\n\nA new addition is to break-out of the strict construct and allow a priority to be assigned to a middleware. The higher the number for a middleware definition, the earlier in the sequence it will be executed. This applies to **both** request and response middleware.\n\n```python\n@app.on_request\nasync def low_priority(_):\n ...\n\n@app.on_request(priority=10)\nasync def high_priority(_):\n ...\n```\n\nIn the above example, even though `low_priority` is defined first, `high_priority` will run first.\n\n### Custom `loads` function\n\nSanic has supported the ability to add a [custom `dumps` function](https://sanic.readthedocs.io/en/stable/sanic/api/app.html#sanic.app.Sanic) when instantiating an app. The same functionality has been extended to `loads`, which will be used when deserializing.\n\n```python\nfrom json import loads\n\nSanic(\"Test\", loads=loads)\n```\n\n### Websocket objects are now iterable\n\nRather than calling `recv` in a loop on a `Websocket` object, you can iterate on it in a `for` loop.\n\n```python\nfrom sanic import Request, Websocket\n\n@app.websocket(\"/ws\")\nasync def ws_echo_handler(request: Request, ws: Websocket):\n async for msg in ws:\n await ws.send(msg)\n```\n\n### Appropriately respond with 304 on static files\n\nWhen serving a static file, the Sanic server can respond appropriately to a request with `If-Modified-Since` using a `304` response instead of resending a file.\n\n### Two new signals to wrap handler execution\n\nTwo new [signals](../../guide/advanced/signals.md) have been added that wrap the execution of a request handler.\n\n- `http.handler.before` - runs after request middleware but before the route handler\n- `http.handler.after` - runs after the route handler\n - In *most* circumstances, this also means that it will run before response middleware. However, if you call `request.respond` from inside of a route handler, then your middleware will come first\n\n### New Request properties for HTTP method information\n\nThe HTTP specification defines which HTTP methods are: safe, idempotent, and cacheable. New properties have been added that will respond with a boolean flag to help identify the request property based upon the method.\n\n```python\nrequest.is_safe\nrequest.is_idempotent\nrequest.is_cacheable\n```\n\n### 🚨 *BREAKING CHANGE* - Improved cancel request exception\n\nIn prior version of Sanic, if a `CancelledError` was caught it could bubble up and cause the server to respond with a `503`. This is not always the desired outcome, and it prevented the usage of that error in other circumstances. As a result, Sanic will now use a subclass of `CancelledError` called: `RequestCancelled` for this functionality. It likely should have little impact unless you were explicitly relying upon the old behavior.\n\nFor more details on the specifics of these properties, checkout the [MDN docs](https://developer.mozilla.org/en-US/docs/Web/HTTP/Methods).\n\n### New deprecation warning filter\n\nYou can control the level of deprecation warnings from Sanic using [standard library warning filter values](https://docs.python.org/3/library/warnings.html#the-warnings-filter). Default is `\"once\"`.\n\n```python\napp.config.DEPRECATION_FILTER = \"ignore\"\n```\n\n### Deprecations and Removals\n\n1. *DEPRECATED* - Duplicate route names have been deprecated and will be removed in v23.3\n1. *DEPRECATED* - Registering duplicate exception handlers has been deprecated and will be removed in v23.3\n1. *REMOVED* - `route.ctx` not set by Sanic, and is a blank object for users, therefore ...\n - `route.ctx.ignore_body` >> `route.extra.ignore_body`\n - `route.ctx.stream` >> `route.extra.stream`\n - `route.ctx.hosts` >> `route.extra.hosts`\n - `route.ctx.static` >> `route.extra.static`\n - `route.ctx.error_format` >> `route.extra.error_format`\n - `route.ctx.websocket` >> `route.extra.websocket`\n1. *REMOVED* - `app.debug` is READ-ONLY\n1. *REMOVED* - `app.is_running` removed\n1. *REMOVED* - `app.is_stopping` removed\n1. *REMOVED* - `Sanic._uvloop_setting` removed\n1. *REMOVED* - Prefixed environment variables will be ignored if not uppercase\n\n## Thank you\n\nThank you to everyone that participated in this release: :clap:\n\n[@ahopkins](https://github.com/ahopkins)\n[@azimovMichael](https://github.com/azimovMichael)\n[@ChihweiLHBird](https://github.com/ChihweiLHBird)\n[@huntzhan](https://github.com/huntzhan)\n[@monosans](https://github.com/monosans)\n[@prryplatypus](https://github.com/prryplatypus)\n[@SaidBySolo](https://github.com/SaidBySolo)\n[@seemethere](https://github.com/seemethere)\n[@sjsadowski](https://github.com/sjsadowski)\n[@timgates42](https://github.com/timgates42)\n[@Tronic](https://github.com/Tronic)\n\n---\n\nIf you enjoy the project, please consider contributing. Of course we love code contributions, but we also love contributions in any form. Consider writing some documentation, showing off use cases, joining conversations and making your voice known, and if you are able: [financial contributions](https://opencollective.com/sanic-org/).\n" }, { "path": "guide/content/en/release-notes/2023/v23.12.md", "content": "---\ntitle: Version 23.12\n---\n\n# Version 23.12 (LTS)\n\n.. toc::\n\n\n## Introduction\n\nThis is the final release of the version 23 [release cycle](../../organization/policies.md#release-schedule). It is designated as a **long-term support (\"LTS\") release**, which means it will receive support for two years as stated in the support policy. If you run into any issues, please raise a concern on [GitHub](https://github.com/sanic-org/sanic/issues/new/choose.)\n\n## What to know\n\nMore details in the [Changelog](../changelog.html). Notable new or breaking features, and what to upgrade:\n\n### 🎉 Documentation now using {span:has-text-primary:Sanic}\n\n![](http://127.0.0.1:8000/assets/images/sanic-framework-logo-circle-128x128.png)\n\nYou can read [all about how](/en/built-with-sanic.html), but we converted this documentation site to using the SHH 🤫 stack.\n\n- [Sanic](https://sanic.dev)\n- [html5tagger](https://github.com/sanic-org/html5tagger)\n- [HTMX](https://htmx.org/)\n\n### 👶 *BETA* Welcome to the Sanic interactive console\n\nThat's right, Sanic now ships with a REPL!\n\n![](/assets/images/repl.png)\n\nWhen using the Sanic CLI, you can pass the `--repl` argument to automatically run an interactive console along side your application. This is extremely helpful while developing, and allows you access to the application instance, as well as a built-in client enabled to send HTTP requests to the running instance.\n\nIf you use the `--dev` flag, this feature is quasi-enabled by default. While it will not outright run the REPL, it will start the process and allow you to enter the REPL at anytime by hitting `` on your keyboard.\n\n*This is still in BETA mode. We would appreciate you letting us know about any any enhancement requests or issues.*\n\n### Python 3.12 support\n\nWe have added Python 3.12 to the supported versions.\n\n### Start and restart arbitrary processes\n\nUsing the [multiplexer](../../guide/running/manager.md#access-to-the-multiplexer), you can now start and restart arbitrary or pre-existing processes. This enabled the following new features in the way the multiplexer and worker manager operate:\n\n1. `multiplexer.restart(\"\")` will now restart a targeted single process\n2. `multiplexer.manage(...)` is a new method that works exactly like `manager.manage(...)`\n3. The `manage` methods now have additional keyword arguments:\n - `tracked` - whether the state of the process is tracked after the process completes\n - `restartable` - whether the process should be allowed to be restarted\n - `auto_start` - whether the process should be started immediately after it is created\n\n```python\ndef task(n: int = 10, **kwargs):\n print(\"TASK STARTED\", kwargs)\n for i in range(n):\n print(f\"Running task - Step {i+1} of {n}\")\n sleep(1)\n\n@app.get(\"/restart\")\nasync def restart_handler(request: Request):\n request.app.m.restart(\"Sanic-TEST-0\")\n return json({\"foo\": request.app.m.name})\n\n\n@app.get(\"/start\")\nasync def start_handler(request: Request):\n request.app.m.manage(\"NEW\", task, kwargs={\"n\": 7}, workers=2)\n return json({\"foo\": request.app.m.name})\n\n@app.main_process_ready\ndef start_process(app: Sanic):\n app.manager.manage(\"TEST\", task, kwargs={\"n\": 3}, restartable=True)\n```\n\n### Prioritized listeners and signals\n\nIn [v22.9](../2022/v22.9.md) Sanic added prioritization to middleware to allow arbitrary ordering of middleware. This same concept has now been extended to listeners and signals. This will allow a priority number to be assigned at creation time that will override its default position in the execution timeline.\n\n```python\n@app.before_server_start(priority=3)\nasync def sample(app):\n ...\n```\n\nThe higher the number, the higher priority it will receive. Overall the rules for deciding the order of execution are as follows:\n\n1. Priority in descending order\n2. Application listeners before Blueprint listeners\n3. Registration order\n\n*Remember, some listeners are executed in reverse order*\n\n### Websocket signals\n\nWe have added three new signals for websockets:\n\n1. `websocket.handler.before`\n2. `websocket.handler.after`\n3. `websocket.handler.exception`\n\n```python\n@app.signal(\"websocket.handler.before\")\nasync def ws_before(request: Request, websocket: Websocket):\n ...\n\n@app.signal(\"websocket.handler.after\")\nasync def ws_after(request: Request, websocket: Websocket):\n ...\n \n@app.signal(\"websocket.handler.exception\")\nasync def ws_exception(\n request: Request, websocket: Websocket, exception: Exception\n):\n ...\n```\n\n![](https://camo.githubusercontent.com/ea2894c88bedf37a4f12f129569e8fd14bfceaa36d4452c7b7a1869d2f1cdb18/68747470733a2f2f7a692e66692f77732d7369676e616c732e706e67)\n\n### Simplified signals\n\nSanic has always enforced a three part naming convention for signals: `one.two.three`. However, now you can create simpler names that are only a single part.\n\n```python\n@app.signal(\"foo\")\nasync def foo():\n ...\n```\n\nYou can make that part dynamic just like with regular signals and routes:\n\n```python\n@app.signal(\"\")\nasync def handler(**kwargs):\n print(\"foobar signal received\")\n print(kwargs)\n\n\n@app.route(\"/\")\nasync def test(request: Request):\n await request.app.dispatch(\"foobar\")\n return json({\"hello\": \"world\"})\n```\n\nIf you need to have multiple dynamic signals, then you should use the longer three-part format.\n\n### The `event` method has been updated\n\nA number of changes have been made to both `app.event()` and `blueprint.event()`.\n\n- `condition` and `exclusive` are keywords to control matching conditions (similar to the `signal()` methods)\n- You can pass either a `str` or an `Enum` (just like `signal()`)\n- returns a copy of the context that was passed to the `dispatch()` method\n\n### Reload trigger gets changed files\n\nThe files changed by the reloader are now injected into the listener. This will allow the trigger to do something with knowledge of what those changed files were.\n\n```python\n@app.after_reload_trigger\nasync def after_reload_trigger(_, changed):\n print(changed)\n```\n\n## Thank you\n\nThank you to everyone that participated in this release: :clap:\n\n[@ahopkins](https://github.com/ahopkins)\n[@ChihweiLHBird](https://github.com/ChihweiLHBird)\n[@freddiewanah](https://github.com/freddiewanah)\n[@gluhar2006](https://github.com/gluhar2006)\n[@iAndriy](https://github.com/iAndriy)\n[@MichaelHinrichs](https://github.com/MichaelHinrichs)\n[@prryplatypus](https://github.com/prryplatypus)\n[@SaidBySolo](https://github.com/SaidBySolo)\n[@sjsadowski](https://github.com/sjsadowski)\n[@talljosh](https://github.com/talljosh)\n[@tjni](https://github.com/tjni)\n[@Tronic](https://github.com/Tronic)\n\n---\n\nIf you enjoy the project, please consider contributing. Of course we love code contributions, but we also love contributions in any form. Consider writing some documentation, showing off use cases, joining conversations and making your voice known, and if you are able: [financial contributions](https://opencollective.com/sanic-org/).\n" }, { "path": "guide/content/en/release-notes/2023/v23.3.md", "content": "---\ntitle: Version 23.3\n---\n\n# Version 23.3\n\n.. toc::\n\n## Introduction\n\nThis is the first release of the version 23 [release cycle](../../organization/policies.md#release-schedule). As such contains some deprecations and hopefully some *small* breaking changes. If you run into any issues, please raise a concern on [GitHub](https://github.com/sanic-org/sanic/issues/new/choose).\n\n## What to know\n\nMore details in the [Changelog](https://sanic.readthedocs.io/en/stable/sanic/changelog.html). Notable new or breaking features, and what to upgrade...\n\n### Nicer traceback formatting\n\nThe SCO adopted two projects into the Sanic namespace on GitHub: [tracerite](https://github.com/sanic-org/tracerite) and [html5tagger](https://github.com/sanic-org/html5tagger). These projects team up to provide and incredible new error page with more details to help the debugging process.\n\nThis is provided out of the box, and will adjust to display only relevant information whether in DEBUG more or PROD mode.\n\n.. column::\n\n **Using PROD mode**\n ![image](/assets/images/error-html-no-debug.png)\n\n.. column::\n\n **Using DEBUG mode**\n ![image](/assets/images/error-html-debug.png)\n\nLight and dark mode HTML pages are available and will be used implicitly.\n\n### Basic file browser on directories\n\nWhen serving a directory from a static handler, Sanic can be configured to show a basic file browser instead using `directory_view=True`.\n\n.. column::\n\n ```python\n app.static(\"/uploads/\", \"/path/to/dir/\", directory_view=True)\n ```\n\n.. column::\n\n ![image](/assets/images/directory-view.png)\n\nLight and dark mode HTML pages are available and will be used implicitly.\n\n### HTML templating with Python\n\nBecause Sanic is using [html5tagger](https://github.com/sanic-org/html5tagger) under the hood to render the [new error pages](#nicer-traceback-formatting), you now have the package available to you to easily generate HTML pages in Python code:\n\n.. column::\n\n ```python\n from html5tagger import Document\n from sanic import Request, Sanic, html\n\n app = Sanic(\"TestApp\")\n\n @app.get(\"/\")\n async def handler(request: Request):\n doc = Document(\"My Website\")\n doc.h1(\"Hello, world.\")\n with doc.table(id=\"data\"):\n doc.tr.th(\"First\").th(\"Second\").th(\"Third\")\n doc.tr.td(1).td(2).td(3)\n doc.p(class_=\"text\")(\"A paragraph with \")\n doc.a(href=\"/files\")(\"a link\")(\" and \").em(\"formatting\")\n return html(doc)\n ```\n\n.. column::\n\n ```html\n \n \n My Website\n

Hello, world.

\n \n \n \n
First\n Second\n Third\n
1\n 2\n 3\n
\n

\n A paragraph with a link and formatting\n ```\n\n### Auto-index serving is available on static handlers\n\nSanic can now be configured to serve an index file when serving a static directory.\n\n```python\napp.static(\"/assets/\", \"/path/to/some/dir\", index=\"index.html\")\n```\n\nWhen using the above, requests to `http://example.com/assets/` will automatically serve the `index.html` file located in that directory.\n\n### Simpler CLI targets\n\nIt is common practice for Sanic applications to use the variable `app` as the application instance. Because of this, the CLI application target (the second value of the `sanic` CLI command) now tries to infer the application instance based upon what the target is. If the target is a module that contains an `app` variable, it will use that.\n\nThere are now four possible ways to launch a Sanic application from the CLI.\n\n#### 1. Application instance\n\nAs normal, providing a path to a module and an application instance will work as expected.\n\n```sh\nsanic path.to.module:app # global app instance\n```\n\n#### 2. Application factory\n\nPreviously, to serve the factory pattern, you would need to use the `--factory` flag. This can be omitted now.\n\n```sh\nsanic path.to.module:create_app # factory pattern\n```\n\n#### 3. Path to launch Sanic Simple Server\n\nSimilarly, to launch the Sanic simple server (serve static directory), you previously needed to use the `--simple` flag. This can be omitted now, and instead simply provide the path to the directory.\n\n```sh\nsanic ./path/to/directory/ # simple serve\n```\n\n#### 4. Python module containing an `app` variable\n\nAs stated above, if the target is a module that contains an `app` variable, it will use that (assuming that `app` variable is a `Sanic` instance).\n\n```sh\nsanic path.to.module # module with app instance\n```\n\n### More convenient methods for setting and deleting cookies\n\nThe old cookie pattern was awkward and clunky. It didn't look like regular Python because of the \"magic\" going on under the hood.\n\n.. column::\n\n 😱 This is not intuitive and is confusing for newcomers.\n\n.. column::\n\n ```python\n response = text(\"There's a cookie up in this response\")\n response.cookies[\"test\"] = \"It worked!\"\n response.cookies[\"test\"][\"domain\"] = \".yummy-yummy-cookie.com\"\n response.cookies[\"test\"][\"httponly\"] = True\n ```\n\nThere are now new methods (and completely overhauled `Cookie` and `CookieJar` objects) to make this process more convenient.\n\n.. column::\n\n 😌 Ahh... Much nicer.\n\n.. column::\n\n ```python\n response = text(\"There's a cookie up in this response\")\n response.add_cookie(\n \"test\",\n \"It worked!\",\n domain=\".yummy-yummy-cookie.com\",\n httponly=True\n )\n ```\n\n### Better cookie compatibility\n\nSanic has added support for [cookie prefixes](https://developer.mozilla.org/en-US/docs/Web/HTTP/Cookies#cookie_prefixes), making it seemless and easy to read and write cookies with the values.\n\nWhile setting the cookie...\n\n```py\nresponse.cookies.add_cookie(\"foo\", \"bar\", host_prefix=True)\n```\n\nThis will create the prefixed cookie: `__Host-foo`. However, when accessing the cookie on an incoming request, you can do so without knowing about the existence of the header.\n\n```py\nrequest.cookies.get(\"foo\")\n```\n\nIt should also be noted, cookies can be accessed as properties just like [headers](#access-any-header-as-a-property).\n\n```python\nrequest.cookies.foo\n```\n\nAnd, cookies are similar to the `request.args` and `request.form` objects in that multiple values can be retrieved using `getlist`.\n\n```py\nrequest.cookies.getlist(\"foo\")\n```\n\nAlso added is support for creating [partitioned cookies](https://developer.mozilla.org/en-US/docs/Web/HTTP/Headers/Set-Cookie#partitioned_cookie).\n\n```py\nresponse.cookies.add_cookie(..., partitioned=True)\n```\n\n### 🚨 *BREAKING CHANGE* - More consistent and powerful `SanicException`\n\nSanic has for a while included the `SanicException` as a base class exception. This could be extended to add `status_code`, etc. [See more details](http://localhost:8080/en/guide/best-practices/exceptions.html).\n\n**NOW**, using all of the various exceptions has become easier. The commonly used exceptions can be imported directly from the root level module.\n\n```python\nfrom sanic import NotFound, Unauthorized, BadRequest, ServerError\n```\n\nIn addition, all of these arguments are available as keyword arguments on every exception type:\n\n| argument | type | description |\n|--|--|--|\n| `quiet` | `bool` | Suppress the traceback from the logs |\n| `context` | `dict` | Additional information shown in error pages *always* |\n| `extra` | `dict` | Additional information shown in error pages in *DEBUG* mode |\n| `headers` | `dict` | Additional headers sent in the response |\n\nNone of these are themselves new features. However, they are more consistent in how you can use them, thus creating a powerful way to control error responses directly.\n\n```py\nraise ServerError(headers={\"foo\": \"bar\"})\n```\n\nThe part of this that is a breaking change is that some formerly positional arguments are now keyword only.\n\nYou are encouraged to look at the specific implementations for each error in the [API documents](https://sanic.readthedocs.io/en/stable/sanic/api/exceptions.html#module-sanic.exceptions).\n\n### 🚨 *BREAKING CHANGE* - Refresh `Request.accept` functionality to be more performant and spec-compliant\n\nParsing od the `Accept` headers into the `Request.accept` accessor has been improved. If you were using this property and relying upon its equality operation, this has changed. You should probably transition to using the `request.accept.match()` method.\n\n### Access any header as a property\n\nTo simplify access to headers, you can access a raw (unparsed) version of the header as a property. The name of the header is the name of the property in all lowercase letters, and switching any hyphens (`-`) to underscores (`_`).\n\nFor example:\n\n.. column::\n\n ```\n GET /foo/bar HTTP/1.1\n Host: localhost\n User-Agent: curl/7.88.1\n X-Request-ID: 123ABC\n ```\n\n.. column::\n\n ```py\n request.headers.host\n request.headers.user_agent\n request.headers.x_request_id\n ```\n\n### Consume `DELETE` body by default\n\nBy default, the body of a `DELETE` request will now be consumed and read onto the `Request` object. This will make `body` available like on `POST`, `PUT`, and `PATCH` requests without any further action.\n\n### Custom `CertLoader` for direct control of creating `SSLContext`\n\nSometimes you may want to create your own `SSLContext` object. To do this, you can create your own subclass of `CertLoader` that will generate your desired context object.\n\n```python\nfrom sanic.worker.loader import CertLoader\n\nclass MyCertLoader(CertLoader):\n def load(self, app: Sanic) -> SSLContext:\n ...\n\napp = Sanic(..., certloader_class=MyCertLoader)\n```\n\n### Deprecations and Removals\n\n1. *DEPRECATED* - Dict-style cookie setting\n1. *DEPRECATED* - Using existence of JSON data on the request for one factor in using JSON error formatter\n1. *REMOVED* - Remove deprecated `__blueprintname__` property\n1. *REMOVED* - duplicate route names\n1. *REMOVED* - duplicate exception handler definitions\n1. *REMOVED* - inspector CLI with flags\n1. *REMOVED* - legacy server (including `sanic.server.serve_single` and `sanic.server.serve_multiple`)\n1. *REMOVED* - serving directory with bytes string\n1. *REMOVED* - `Request.request_middleware_started`\n1. *REMOVED* - `Websocket.connection`\n\n#### Duplicated route names are no longer allowed\n\nIn version 22.9, Sanic announced that v23.3 would deprecate allowing routes to be registered with duplicate names. If you see the following error, it is because of that change:\n\n> sanic.exceptions.ServerError: Duplicate route names detected: SomeApp.some_handler. You should rename one or more of them explicitly by using the `name` param, or changing the implicit name derived from the class and function name. For more details, please see https://sanic.dev/en/guide/release-notes/v23.3.html#duplicated-route-names-are-no-longer-allowed\n\nIf you are seeing this, you should opt-in to using explicit names for your routes.\n\n.. column::\n\n **BAD**\n ```python\n app = Sanic(\"SomeApp\")\n\n @app.get(\"/\")\n @app.get(\"/foo\")\n async def handler(request: Request):\n ```\n\n.. column::\n\n **GOOD**\n ```python\n app = Sanic(\"SomeApp\")\n\n @app.get(\"/\", name=\"root\")\n @app.get(\"/foo\", name=\"foo\")\n async def handler(request: Request):\n ```\n\n#### Response cookies\n\nResponse cookies act as a `dict` for compatibility purposes only. In version 24.3, all `dict` methods will be removed and response cookies will be objects only.\n\nTherefore, if you are using this pattern to set cookie properties, you will need to upgrade it before version 24.3.\n\n```python\nresp = HTTPResponse()\nresp.cookies[\"foo\"] = \"bar\"\nresp.cookies[\"foo\"][\"httponly\"] = True\n```\n\nInstead, you should be using the `add_cookie` method:\n\n```python\nresp = HTTPResponse()\nresp.add_cookie(\"foo\", \"bar\", httponly=True)\n```\n\n#### Request cookies\n\nSanic has added support for reading duplicated cookie keys to be more in compliance with RFC specifications. To retain backwards compatibility, accessing a cookie value using `__getitem__` will continue to work to fetch the first value sent. Therefore, in version 23.3 and prior versions this will be `True`.\n\n```python\nassert request.cookies[\"foo\"] == \"bar\"\nassert request.cookies.get(\"foo\") == \"bar\"\n```\n\nVersion 23.3 added `getlist`\n\n```python\nassert request.cookies.getlist(\"foo\") == [\"bar\"]\n```\n\nAs stated above, the `get` and `getlist` methods are available similar to how they exist on other request properties (`request.args`, `request.form`, etc). Starting in v24.3, the `__getitem__` method for cookies will work exactly like those properties. This means that `__getitem__` will return a list of values.\n\nTherefore, if you are relying upon this functionality to return only one value, you should upgrade to the following pattern before v24.3.\n\n```python\nassert request.cookies[\"foo\"] == [\"bar\"]\nassert request.cookies.get(\"foo\") == \"bar\"\nassert request.cookies.getlist(\"foo\") == [\"bar\"]\n```\n\n## Thank you\n\nThank you to everyone that participated in this release: :clap:\n\n[@ahopkins](https://github.com/ahopkins)\n[@ChihweiLHBird](https://github.com/ChihweiLHBird)\n[@deounix](https://github.com/deounix)\n[@Kludex](https://github.com/Kludex)\n[@mbendiksen](https://github.com/mbendiksen)\n[@prryplatypus](https://github.com/prryplatypus)\n[@r0x0d](https://github.com/r0x0d)\n[@SaidBySolo](https://github.com/SaidBySolo)\n[@sjsadowski](https://github.com/sjsadowski)\n[@stricaud](https://github.com/stricaud)\n[@Tracyca209](https://github.com/Tracyca209)\n[@Tronic](https://github.com/Tronic)\n\n---\n\nIf you enjoy the project, please consider contributing. Of course we love code contributions, but we also love contributions in any form. Consider writing some documentation, showing off use cases, joining conversations and making your voice known, and if you are able: [financial contributions](https://opencollective.com/sanic-org/).\n" }, { "path": "guide/content/en/release-notes/2023/v23.6.md", "content": "---\ntitle: Version 23.6\n---\n\n# Version 23.6\n\n.. toc::\n\n\n## Introduction\n\nThis is the second release of the version 23 [release cycle](../../organization/policies.md#release-schedule). If you run into any issues, please raise a concern on [GitHub](https://github.com/sanic-org/sanic/issues/new/choose).\n\n## What to know\n\nMore details in the [Changelog](https://sanic.readthedocs.io/en/stable/sanic/changelog.html). Notable new or breaking features, and what to upgrade...\n\n### Remove Python 3.7 support\n\nPython 3.7 is due to reach its scheduled upstream end-of-life on 2023-06-27. Sanic is now dropping support for Python 3.7, and requires Python 3.8 or newer.\n\nSee [#2777](https://github.com/sanic-org/sanic/pull/2777).\n\n### Resolve pypy compatibility issues\n\nA small patch was added to the `os` module to once again allow for Sanic to run with PyPy. This workaround replaces the missing `readlink` function (missing in PyPy `os` module) with the function `os.path.realpath`, which serves to the same purpose.\n\nSee [#2782](https://github.com/sanic-org/sanic/pull/2782).\n\n### Add custom typing to config and ctx objects\n\nThe `sanic.Sanic` and `sanic.Request` object have become generic types that will make it more convenient to have fully typed `config` and `ctx` objects.\n\nIn the most simple form, the `Sanic` object is typed as:\n\n```python\nfrom sanic import Sanic\napp = Sanic(\"test\")\nreveal_type(app) # N: Revealed type is \"sanic.app.Sanic[sanic.config.Config, types.SimpleNamespace]\"\n```\n\n\n.. tip:: Note\n\n It should be noted, there is *no* requirement to use the generic types. The default types are `sanic.config.Config` and `types.SimpleNamespace`. This new feature is just an option for those that want to use it and existing types of `app: Sanic` and `request: Request` should work just fine.\n\n\nNow it is possible to have a fully-type `app.config`, `app.ctx`, and `request.ctx` objects though generics. This allows for better integration with auto completion tools in IDEs improving the developer experience.\n\n```python\nfrom sanic import Request, Sanic\nfrom sanic.config import Config\n\nclass CustomConfig(Config):\n pass\n\nclass Foo:\n pass\n\nclass RequestContext:\n foo: Foo\n\nclass CustomRequest(Request[Sanic[CustomConfig, Foo], RequestContext]):\n @staticmethod\n def make_context() -> RequestContext:\n ctx = RequestContext()\n ctx.foo = Foo()\n return ctx\n\napp = Sanic(\n \"test\", config=CustomConfig(), ctx=Foo(), request_class=CustomRequest\n)\n\n@app.get(\"/\")\nasync def handler(request: CustomRequest):\n ...\n```\n\nAs a side effect, now `request.ctx` is lazy initialized, which should reduce some overhead when the `request.ctx` is unused.\n\nOne further change you may have noticed in the above snippet is the `make_context` method. This new method can be used by custom `Request` types to inject an object different from a `SimpleNamespace` similar to how Sanic has allowed custom application context objects for a while.\n\nFor a more thorough discussion, see [custom typed application](../../guide/basics/app.md#custom-typed-application) and [custom typed request](../../guide/basics/app.md#custom-typed-request).\n\nSee [#2785](https://github.com/sanic-org/sanic/pull/2785).\n\n### Universal exception signal\n\nA new exception signal added for **ALL** exceptions raised while the server is running: `\"server.exception.reporting\"`. This is a universal signal that will be emitted for any exception raised, and dispatched as its own task. This means that it will *not* block the request handler, and will *not* be affected by any middleware.\n\nThis is useful for catching exceptions that may occur outside of the request handler (for example in signals, or in a background task), and it intended for use to create a consistent error handling experience for the user.\n\n```python\nfrom sanic.signals import Event\n\n@app.signal(Event.SERVER_LIFECYCLE_EXCEPTION)\nasync def catch_any_exception(app: Sanic, exception: Exception):\n app.ctx.my_error_reporter_utility.error(exception)\n```\n\nThis pattern can be simplified with a new decorator `@app.report_exception`:\n\n```python\n@app.report_exception\nasync def catch_any_exception(app: Sanic, exception: Exception):\n print(\"Caught exception:\", exception)\n```\n\nIt should be pointed out that this happens in a background task and is **NOT** for manipulation of an error response. It is only for reporting, logging, or other purposes that should be triggered when an application error occurs.\n\nSee [#2724](https://github.com/sanic-org/sanic/pull/2724) and [#2792](https://github.com/sanic-org/sanic/pull/2792).\n\n### Add name prefixing to BP groups\n\nSanic had been raising a warning on duplicate route names for a while, and started to enforce route name uniqueness in [v23.3](https://sanic.dev/en/guide/release-notes/v23.3.html#deprecations-and-removals). This created a complication for blueprint composition.\n\nNew name prefixing parameter for blueprints groups has been added to alleviate this issue. It allows nesting of blueprints and groups to make them composable.\n\nThe addition is the new `name_prefix` parameter as shown in this snippet.\n\n```python\nbp1 = Blueprint(\"bp1\", url_prefix=\"/bp1\")\nbp2 = Blueprint(\"bp2\", url_prefix=\"/bp2\")\n\nbp1.add_route(lambda _: ..., \"/\", name=\"route1\")\nbp2.add_route(lambda _: ..., \"/\", name=\"route2\")\n\ngroup_a = Blueprint.group(\n bp1, bp2, url_prefix=\"/group-a\", name_prefix=\"group-a\"\n)\ngroup_b = Blueprint.group(\n bp1, bp2, url_prefix=\"/group-b\", name_prefix=\"group-b\"\n)\n\napp = Sanic(\"TestApp\")\napp.blueprint(group_a)\napp.blueprint(group_b)\n```\n\nThe routes built will be named as follows:\n- `TestApp.group-a_bp1.route1`\n- `TestApp.group-a_bp2.route2`\n- `TestApp.group-b_bp1.route1`\n- `TestApp.group-b_bp2.route2`\n\nSee [#2727](https://github.com/sanic-org/sanic/pull/2727).\n\n### Add `request.client_ip`\n\nSanic has introduced `request.client_ip`, a new accessor that provides client's IP address from both local and proxy data. It allows running the application directly on Internet or behind a proxy. This is equivalent to `request.remote_addr or request.ip`, providing the client IP regardless of how the application is deployed.\n\nSee [#2790](https://github.com/sanic-org/sanic/pull/2790).\n\n### Increase of `KEEP_ALIVE_TIMEOUT` default to 120 seconds\n\nThe default `KEEP_ALIVE_TIMEOUT` value changed from 5 seconds to 120 seconds. It is of course still configurable, but this change should improve performance on long latency connections, where reconnecting is expensive, and better fits typical user flow browsing pages with longer-than-5-second intervals.\n\nSanic has historically used 5 second timeouts to quickly close idle connections. The chosen value of **120 seconds** is indeed larger than Nginx default of 75, and is the same value that Caddy server has by default.\n\nRelated to [#2531](https://github.com/sanic-org/sanic/issues/2531) and \n[#2681](https://github.com/sanic-org/sanic/issues/2681). \n\nSee [#2670](https://github.com/sanic-org/sanic/pull/2670).\n\n### Set multiprocessing start method early\n\nDue to how Python handles `multiprocessing`, it may be confusing to some users how to properly create synchronization primitives. This is due to how Sanic creates the `multiprocessing` context. This change sets the start method early so that any primitives created will properly attach to the correct context.\n\nFor most users, this should not be noticeable or impactful. But, it should make creation of something like this easier and work as expected.\n\n```python\nfrom multiprocessing import Queue\n\n@app.main_process_start\nasync def main_process_start(app):\n app.shared_ctx.queue = Queue()\n```\n\nSee [#2776](https://github.com/sanic-org/sanic/pull/2776).\n\n## Thank you\n\nThank you to everyone that participated in this release: :clap:\n\n[@ahopkins](https://github.com/ahopkins)\n[@ChihweiLHBird](https://github.com/ChihweiLHBird)\n[@chuckds](https://github.com/chuckds)\n[@deounix](https://github.com/deounix)\n[@guacs](https://github.com/guacs)\n[@liamcoatman](https://github.com/liamcoatman)\n[@moshe742](https://github.com/moshe742)\n[@prryplatypus](https://github.com/prryplatypus)\n[@SaidBySolo](https://github.com/SaidBySolo)\n[@Thirumalai](https://github.com/Thirumalai)\n[@Tronic](https://github.com/Tronic)\n\n---\n\nIf you enjoy the project, please consider contributing. Of course we love code contributions, but we also love contributions in any form. Consider writing some documentation, showing off use cases, joining conversations and making your voice known, and if you are able: [financial contributions](https://opencollective.com/sanic-org/).\n" }, { "path": "guide/content/en/release-notes/2023/v23.9.md", "content": "---\ntitle: Version 23.9\n---\n\n# Version 23.9\n\n_Due to circumstances at the time, v.23.9 was skipped._\n" }, { "path": "guide/content/en/release-notes/2024/v24.12.md", "content": "---\ntitle: Version 24.12\n---\n\n# Version 24.12\n\n.. toc::\n\n\n## Introduction\n\nThis is the first release of the version 24 [release cycle](../../organization/policies.md#release-schedule). The release cadence for v24 may be slightly altered from years past. Make sure to stay up to date in the Discord server for latest updates. If you run into any issues, please raise a concern on [GitHub](https://github.com/sanic-org/sanic/issues/new/choose).\n\n## What to know\n\nMore details in the [Changelog](../changelog.html). Notable new or breaking features, and what to upgrade:\n\n### 👶 _BETA_ Custom CLI commands\n\nThe `sanic` CLI utility now allows for custom commands to be invoked. Commands can be added using the decorator syntax below.\n\n```python\n@app.command\nasync def foo(one, two: str, three: str = \"...\"):\n logger.info(f\"FOO {one=} {two=} {three=}\")\n\n\n@app.command\ndef bar():\n logger.info(\"BAR\")\n\n\n@app.command(name=\"qqq\")\nasync def baz():\n logger.info(\"BAZ\")\n```\n\nThese are invoked using the `exec` command as follows.\n\n```sh\nsanic server:app exec [--arg=value]\n```\n\nAny arguments in the function's signature will be added as arguments. For example:\n\n```sh\nsanic server:app exec command --one=1 --two=2 --three=3\n```\n\n.. warning::\n\n This is in **BETA** and the functionality is subject to change in upcoming versions.\n\n### Add Python 3.13 support\n\nWe have added Python 3.13 to the supported versions.\n\n### Remove Python 3.8 support\n\nPython 3.8 reached end-of-life. Sanic is now dropping support for Python 3.8, and requires Python 3.9 or newer.\n\n### Old response cookie accessors removed\n\nPrior to v23, cookies on `Response` objects were set and accessed as dictionary objects. That was deprecated in v23.3 when the new [convenience methods](../2023/v23.3.html#more-convenient-methods-for-setting-and-deleting-cookies) were added. The old patterns have been removed.\n\n## Thank you\n\nThank you to everyone that participated in this release: :clap:\n\n[@ahopkins](https://github.com/ahopkins)\n[@C5H12O5](https://github.com/C5H12O5)\n[@ChihweiLHBird](https://github.com/ChihweiLHBird)\n[@HyperKiko](https://github.com/HyperKiko)\n[@imnotjames](https://github.com/imnotjames)\n[@pygeek](https://github.com/pygeek)\n\n---\n\nIf you enjoy the project, please consider contributing. Of course we love code contributions, but we also love contributions in any form. Consider writing some documentation, showing off use cases, joining conversations and making your voice known, and if you are able: [financial contributions](https://opencollective.com/sanic-org/).\n" }, { "path": "guide/content/en/release-notes/2024/v24.6.md", "content": "---\ntitle: Version 24.6\n---\n\n# Version 24.6\n\n.. toc::\n\n\n## Introduction\n\nThis is the first release of the version 24 [release cycle](../../organization/policies.md#release-schedule). The release cadence for v24 may be slightly altered from years past. Make sure to stay up to date in the Discord server for latest updates. If you run into any issues, please raise a concern on [GitHub](https://github.com/sanic-org/sanic/issues/new/choose).\n\n## What to know\n\nMore details in the [Changelog](../changelog.html). Notable new or breaking features, and what to upgrade:\n\n### Logging improvements\n\nThe default logging patterns have been cleaned up to make them much more developer-friendly when viewing from a terminal session. This includes the use of color and less verbose formatting.\n\nSanic will select between two slight variations depending upon whether your server is in DEBUG mode. You can always opt to remove colors by using:\n\n```python\napp.config.NO_COLOR = True\n```\n\nThe color will automatically be stripped out from logs not in TTY terminal.\n\nSanic will switch between the DEBUG and PROD formatters automatically using `sanic.logging.formatter.AutoFormatter` and `sanic.logging.formatter.AutoAccessFormatter`. Of course, you can force one version or the other using the appropriately named formatters\n\n#### In DEBUG mode\n\n```python\nsanic.logging.formatter.DebugFormatter\nsanic.logging.formatter.DebugAccessFormatter\n```\n\n![](/assets/images/logging-dev.png)\n\n#### In PROD mode\n\n\n```python\nsanic.logging.formatter.ProdFormatter\nsanic.logging.formatter.ProdAccessFormatter\n```\n\n![](/assets/images/logging-prod.png)\n\n#### Legacy\n\nIf you prefer the old-style of logging, these have been preserved for you as logging formatters: `sanic.logging.formatter.LegacyFormatter` and `sanic.logging.formatter.LegacyAccessFormatter`.\n\nOne way to implement these formatters:\n\n```python\nfrom sanic.log import LOGGING_CONFIG_DEFAULTS\n\nLOGGING_CONFIG_DEFAULTS[\"formatters\"] = {\n \"generic\": {\n \"class\": \"sanic.logging.formatter.LegacyFormatter\"\n },\n \"access\": {\n \"class\": \"sanic.logging.formatter.LegacyAccessFormatter\"\n },\n}\n```\n\n#### New JSON formatter\n\nThere also is a new JSON log formatter that will output the logs in JSON format for integration with other third part logging platforms.\n\n\n```python\nfrom sanic.log import LOGGING_CONFIG_DEFAULTS\n\nLOGGING_CONFIG_DEFAULTS[\"formatters\"] = {\n \"generic\": {\n \"class\": \"sanic.logging.formatter.JSONFormatter\"\n },\n \"access\": {\n \"class\": \"sanic.logging.formatter.JSONAccessFormatter\"\n },\n}\n```\n\n### Using Paths in unix sockets\n\nWhen creating a unix socket for your server, you can now perform that by passing a `pathlib.Path` object instead of just a string-based path\n\n### Custom route names\n\nYou can override the `generate_name` method on either a custom `Sanic` or a `Blueprint`. This will allow you to modify the route names at will.\n\n```python\nfrom sanic import Sanic, text,\n\nclass Custom(Sanic):\n def generate_name(self, *objects):\n existing = self._generate_name(*objects)\n return existing.upper()\n \napp = Sanic(\"Foo\")\n\n@app.get(\"/\")\nasync def handler(request):\n return text(request.name) # FOO.HANDLER\n\n \nreturn app\n```\n\n### 🚨 BREAKING CHANGES\n\n1. `Request.cookies.getlist` always returns a `list`. This means when no cookie of `key` exists, it will be an empty `list` instead of `None`. Use `Request.cookies.getlist(\"something\", None)` to retain existing behavior.\n\n\n## Thank you\n\nThank you to everyone that participated in this release: :clap:\n\n[@ahopkins](https://github.com/ahopkins)\n[@ashleysommer](https://github.com/ashleysommer)\n[@ChihweiLHBird](https://github.com/ChihweiLHBird)\n[@DeJayDev](https://github.com/DeJayDev)\n[@ekzhang](https://github.com/ekzhang)\n[@Huy-Ngo](https://github.com/Huy-Ngo)\n[@iAndriy](https://github.com/iAndriy)\n[@jakkaz](https://github.com/jakkaz)\n[@Nano112](https://github.com/Nano112)\n[@prryplatypus](https://github.com/prryplatypus)\n[@razodactyl](https://github.com/razodactyl)\n[@Tronic](https://github.com/Tronic)\n[@wieczorek1990](https://github.com/wieczorek1990)\n\n---\n\nIf you enjoy the project, please consider contributing. Of course we love code contributions, but we also love contributions in any form. Consider writing some documentation, showing off use cases, joining conversations and making your voice known, and if you are able: [financial contributions](https://opencollective.com/sanic-org/).\n" }, { "path": "guide/content/en/release-notes/2025/v25.12.md", "content": "---\ntitle: Version 25.12 (LTS)\n---\n\n# Version 25.12 (LTS)\n\n.. toc::\n\n\n## Introduction\n\nVersion 25.12 is the **Long Term Support (LTS)** release for the version 25 [release cycle](../../organization/policies.md#release-schedule). As an LTS release, it will receive security updates and critical bug fixes for an extended period. If you run into any issues, please raise a concern on [GitHub](https://github.com/sanic-org/sanic/issues/new/choose).\n\n## What to know\n\nMore details in the [Changelog](../changelog.html). Notable new or breaking features, and what to upgrade:\n\n### Python 3.9 removed, Python 3.14 added\n\nSanic now requires **Python 3.10 or newer**. Python 3.9 has been dropped, and Python 3.14 support has been added.\n\n### Daemon mode\n\nYou can now run Sanic as a background daemon process directly from the CLI.\n\n```sh\nsanic path.to.app -D\nsanic path.to.app --daemon\n```\n\nThis also introduces convenience commands for managing daemon processes:\n\n```sh\nsanic path.to.app status # Check if running\nsanic path.to.app stop # Stop the daemon\n```\n\nAdditional options are available:\n\n```sh\n--pidfile PATH # Custom PID file location\n--logfile PATH # Log output to file\n--user USER # Run as specified user\n--group GROUP # Run as specified group\n```\n\nLower-level commands are also available:\n\n```sh\nsanic kill --pid=\nsanic kill --pidfile=\nsanic status --pid=\nsanic status --pidfile=\n```\n\n### Symlink control for static files\n\nSanic now provides granular control over symlinks in static file serving with two new parameters:\n\n| Parameter | Default | Description |\n|-------------------------------|---------|--------------------------------------------------------------------------------|\n| `follow_external_symlink_files` | `False` | Allow serving file symlinks that point outside the static root |\n| `follow_external_symlink_dirs` | `False` | Allow serving files from directory symlinks that point outside the static root |\n\n**Examples**\n\nSecure defaults (block external symlinks):\n```python\n# Symlinks pointing outside /var/www/static will return 404\napp.static(\"/static\", \"/var/www/static\")\n```\n\nAllow file symlinks only:\n```python\n# Serves /var/www/static/config.json -> /etc/app/config.json\napp.static(\"/static\", \"/var/www/static\", follow_external_symlink_files=True)\n```\n\nAllow directory symlinks only:\n```python\n# Serves files from /var/www/static/images/ -> /shared/images/\napp.static(\"/static\", \"/var/www/static\", follow_external_symlink_dirs=True)\n```\n\n### Custom configuration converters\n\nYou can now extend how Sanic parses environment variables into configuration values. By default, Sanic converts environment variables using `str`, `str_to_bool`, `float`, and `int` converters (tried in reverse order). You can add your own converters to handle custom types.\n\n**Simple converter** - a callable that takes a string and returns a converted value:\n\n```python\nclass UltimateAnswer:\n def __init__(self, answer):\n self.answer = int(answer)\n\nconfig = Config(converters=[UltimateAnswer])\napp = Sanic(\"MyApp\", config=config)\n\n# Or register after creation\napp.config.register_type(UltimateAnswer)\n```\n\n**DetailedConverter** - for converters that need more context (full key name, config key, value, and defaults):\n\n```python\nfrom sanic.config import Config, DetailedConverter\n\nclass TypeAwareConverter(DetailedConverter):\n def __call__(self, full_key: str, config_key: str, value: str, defaults: dict):\n if config_key in defaults:\n # Cast to the same type as the default value\n return type(defaults[config_key])(value)\n raise ValueError # Fall through to next converter\n\nconfig = Config(\n defaults={\"PORT\": 8000, \"DEBUG\": False},\n converters=[TypeAwareConverter()]\n)\n```\n\n### Automatic charset for text content types\n\nText content types (`text/*`) now automatically include `charset=UTF-8` when serving static files and file responses.\n\n### Task creation returns the task\n\nWhen creating a task via `app.add_task()`, the asyncio `Task` object is now returned, allowing you to await or check its result later.\n\n```python\ntask = app.add_task(some_coroutine())\n# Later...\nresult = await task\n```\n\n### Improved CLI error messages\n\nTracerite has been upgraded to v2.2.0, providing better formatted exception tracebacks in the CLI with improved chained exception display.\n\n## Thank you\n\nThank you to everyone that participated in this release: :clap:\n\n[@ahopkins](https://github.com/ahopkins)\n[@amarquard089](https://github.com/amarquard089)\n[@ChihweiLHBird](https://github.com/ChihweiLHBird)\n[@dhensen](https://github.com/dhensen)\n[@dungarpan](https://github.com/dungarpan)\n[@gazpachoking](https://github.com/gazpachoking)\n[@helioascorreia](https://github.com/helioascorreia)\n[@jameslovespancakes](https://github.com/jameslovespancakes)\n[@Peopl3s](https://github.com/Peopl3s)\n[@tdaron](https://github.com/tdaron)\n[@tiejunhu](https://github.com/tiejunhu)\n[@tkosman](https://github.com/tkosman)\n[@Tronic](https://github.com/Tronic)\n[@wojonet](https://github.com/wojonet)\n\n\n---\n\nIf you enjoy the project, please consider contributing. Of course we love code contributions, but we also love contributions in any form. Consider writing some documentation, showing off use cases, joining conversations and making your voice known, and if you are able: [financial contributions](https://opencollective.com/sanic-org/).\n" }, { "path": "guide/content/en/release-notes/2025/v25.3.md", "content": "---\ntitle: Version 25.3\n---\n\n# Version 25.3\n\n.. toc::\n\n\n## Introduction\n\nThis is the first release of the version 25 [release cycle](../../organization/policies.md#release-schedule). The release cadence for v24 may be slightly altered from years past. Make sure to stay up to date in the Discord server for latest updates. If you run into any issues, please raise a concern on [GitHub](https://github.com/sanic-org/sanic/issues/new/choose).\n\n## What to know\n\nMore details in the [Changelog](../changelog.html). Notable new or breaking features, and what to upgrade:\n\n### REPL Context\n\nIn [v23.12](../2023/v23.12.md#-embetaem-welcome-to-the-sanic-interactive-console) we introduced the [Development REPL](/en/guide/running/development.html#development-repl). The goal was to allow you to enter into an enhanced Python REPL from inside your running Sanic application. One of its features is several built-ins to allow you to easily interact with your app and with Sanic.\n\nYou now can add your own custom objects to the REPL\n\n```python\nimport os\n\ndef foo():\n \"\"\"This docstring will show in the REPL\"\"\"\n \napp.repl_ctx.foo = foo\napp.repl_ctx.os = os\n```\n\nThere is also a lower-level API that you can use if (for example) you want to control the help test displayed in the REPL for your objects:\n\n```python\napp.repl_ctx.add(foo)\napp.repl_ctx.add(os, desc=\"Standard os module.\")\n```\n\n\n## Thank you\n\nThank you to everyone that participated in this release: :clap:\n\n[@ahopkins](https://github.com/ahopkins)\n[@erhuabushuo](https://github.com/erhuabushuo)\n[@eric-spitler](https://github.com/eric-spitler)\n[@goodki-d](https://github.com/goodki-d)\n[@SaidBySolo](https://github.com/SaidBySolo)\n\n\n---\n\nIf you enjoy the project, please consider contributing. Of course we love code contributions, but we also love contributions in any form. Consider writing some documentation, showing off use cases, joining conversations and making your voice known, and if you are able: [financial contributions](https://opencollective.com/sanic-org/).\n" }, { "path": "guide/content/en/release-notes/changelog.md", "content": "---\ncontent_class: changelog\n---\n\n# Changelog\n\n🔶 Current release \n🔷 In support LTS release\n\n## Version 25.12.0 🔶\n\n_Current LTS version_\n\n### Features\n- [#3071](https://github.com/sanic-org/sanic/pull/3071) Add automatic `charset=UTF-8` to text content types\n- [#3079](https://github.com/sanic-org/sanic/pull/3079) Add `DetailedConverter` for advanced environment variable conversion\n- [#3080](https://github.com/sanic-org/sanic/pull/3080) Update `str_to_bool` function to include `nope` as a valid false value\n- [#3102](https://github.com/sanic-org/sanic/pull/3102) Better server error messaging\n- [#3110](https://github.com/sanic-org/sanic/pull/3110) Add daemon mode to Sanic CLI\n- [#3114](https://github.com/sanic-org/sanic/pull/3114) Return task when creating a task\n- [#3117](https://github.com/sanic-org/sanic/pull/3117) Explicit symlink params for static files/dirs\n\n### Bugfixes\n- [#3064](https://github.com/sanic-org/sanic/pull/3064) Change the log type to debug\n- [#3068](https://github.com/sanic-org/sanic/pull/3068) Silent on `RuntimeError` when `write_eof`\n- [#3077](https://github.com/sanic-org/sanic/pull/3077) Fix `WorkerManager.kill` on Windows\n- [#3085](https://github.com/sanic-org/sanic/pull/3085) Fix `AttributeError` in `close_if_idle()` when `_http` is not initialized\n- [#3086](https://github.com/sanic-org/sanic/pull/3086) Fix race condition in worker restart causing spawn failure\n- [#3088](https://github.com/sanic-org/sanic/pull/3088) Fixing bad term cleanup at exit\n- [#3119](https://github.com/sanic-org/sanic/pull/3119) Fix static file serving for directories with CJK characters\n- [#3120](https://github.com/sanic-org/sanic/pull/3120) Respect `LOG_EXTRA` in all cases\n- [#3121](https://github.com/sanic-org/sanic/pull/3121) Respect `KEEP_ALIVE` config\n- [#3122](https://github.com/sanic-org/sanic/pull/3122) Check state in shutdown for handling uvloop double kill\n\n### Deprecations and Removals\n- [#3115](https://github.com/sanic-org/sanic/pull/3115) Remove Python 3.9 support and add Python 3.14\n\n### Developer infrastructure\n- [#3083](https://github.com/sanic-org/sanic/pull/3083) Add typing for parameters of constructor of `WorkerManager`\n- [#3084](https://github.com/sanic-org/sanic/pull/3084) Create baseline for bandit to remove false positives\n- [#3091](https://github.com/sanic-org/sanic/pull/3091) Use secrets for generating unique ping payloads\n- [#3094](https://github.com/sanic-org/sanic/pull/3094) Add some typing and fix some tests\n- [#3095](https://github.com/sanic-org/sanic/pull/3095) Update required Python to >=3.10\n- [#3101](https://github.com/sanic-org/sanic/pull/3101) Upgrade tracerite to latest\n- [#3107](https://github.com/sanic-org/sanic/pull/3107) Testing improvements\n- [#3108](https://github.com/sanic-org/sanic/pull/3108) Move to 2-stage coverage check\n- [#3109](https://github.com/sanic-org/sanic/pull/3109) Bump `dawidd6/action-download-artifact` from 3 to 6\n\n### Improved Documentation\n- [#3035](https://github.com/sanic-org/sanic/pull/3035) Fixes `sanic_ext` openapi component documentation\n- [#3054](https://github.com/sanic-org/sanic/pull/3054) Fix 'how we built sanic' sidebar link\n- [#3056](https://github.com/sanic-org/sanic/pull/3056) Fix broken link in website\n- [#3057](https://github.com/sanic-org/sanic/pull/3057) Add correct path for Contribution guidelines\n- [#3065](https://github.com/sanic-org/sanic/pull/3065) Fixed incorrect links throughout the documentation\n- [#3066](https://github.com/sanic-org/sanic/pull/3066) Single letter typo fix for request.md documentation\n\n\n## Version 25.3.0\n\n### Features\n- [#3030](https://github.com/sanic-org/sanic/pull/3030) Improve `websockets` import ordering\n- [#3042](https://github.com/sanic-org/sanic/pull/3042) Add REPL context\n- [#3046](https://github.com/sanic-org/sanic/pull/3046) Support latest v14 `websockets`\n- [#3049](https://github.com/sanic-org/sanic/pull/3049) Subclassing `HTTPMethodView` to allow generics\n\n### Bugfixes\n- [#3047](https://github.com/sanic-org/sanic/pull/3047) Add default to `response.cookies`\n- [#3048](https://github.com/sanic-org/sanic/pull/3048) Add exception logging on connection auto close\n\n\n### Developer infrastructure\n- [#3023](https://github.com/sanic-org/sanic/pull/3023) Cleanup from Python 3.8 removal\n- [#3024](https://github.com/sanic-org/sanic/pull/3024) Improve type hinting\n- [#3028](https://github.com/sanic-org/sanic/pull/3028) Add missing tests\n- [#3041](https://github.com/sanic-org/sanic/pull/3041) Improve GitHub Actions checks\n\n\n## Version 24.12.0 🔷\n\n### Features\n- [#3019](https://github.com/sanic-org/sanic/pull/3019) Add custom commands to `sanic` CLI\n\n### Bugfixes\n- [#2992](https://github.com/sanic-org/sanic/pull/2992) Fix `mixins.startup.serve` UnboundLocalError\n- [#3000](https://github.com/sanic-org/sanic/pull/3000) Fix type annocation for `JSONResponse` method for return type `bytes` allowed for `dumps` callable\n- [#3009](https://github.com/sanic-org/sanic/pull/3009) Fix `SanicException.quiet` attribute handling when set to `False`\n- [#3014](https://github.com/sanic-org/sanic/pull/3014) Cleanup some typing\n- [#3015](https://github.com/sanic-org/sanic/pull/3015) Kill the entire process group if applicable\n- [#3016](https://github.com/sanic-org/sanic/pull/3016) Fix incompatible type annotation of get method in the HTTPMethodView class\n\n### Deprecations and Removals\n- [#3020](https://github.com/sanic-org/sanic/pull/3020) Remove Python 3.8 support\n\n### Developer infrastructure\n- [#3017](https://github.com/sanic-org/sanic/pull/3017) Cleanup setup.cfg\n\n### Improved Documentation\n- [#3007](https://github.com/sanic-org/sanic/pull/3007) Fix typo in documentation for `sanic-ext`\n\n## Version 24.6.0\n\n### Features\n- [#2838](https://github.com/sanic-org/sanic/pull/2838) Simplify request cookies `getlist`\n- [#2850](https://github.com/sanic-org/sanic/pull/2850) Unix sockets can now use `pathlib.Path`\n- [#2931](https://github.com/sanic-org/sanic/pull/2931) [#2958](https://github.com/sanic-org/sanic/pull/2958) Logging improvements\n- [#2947](https://github.com/sanic-org/sanic/pull/2947) Make the .message field on exceptions non-empty\n- [#2961](https://github.com/sanic-org/sanic/pull/2961) [#2964](https://github.com/sanic-org/sanic/pull/2964) Allow for custom name generation\n\n### Bugfixes\n- [#2919](https://github.com/sanic-org/sanic/pull/2919) Remove deprecation notice in websockets\n- [#2937](https://github.com/sanic-org/sanic/pull/2937) Resolve response streaming error when in ASGI mode\n- [#2959](https://github.com/sanic-org/sanic/pull/2959) Resolve Python 3.12 deprecation notic\n- [#2960](https://github.com/sanic-org/sanic/pull/2960) Ensure proper intent for noisy exceptions\n- [#2970](https://github.com/sanic-org/sanic/pull/2970) [#2978](https://github.com/sanic-org/sanic/pull/2978) Fix missing dependencies for 3.12\n- [#2971](https://github.com/sanic-org/sanic/pull/2971) Fix middleware exceptions on Not Found routes with error in middleware\n- [#2973](https://github.com/sanic-org/sanic/pull/2973) Resolve cheduling logic for `transport.close` and `transport.abort`\n- [#2976](https://github.com/sanic-org/sanic/pull/2976) Fix deleting a cookie that was created with `secure=False`\n- [#2979](https://github.com/sanic-org/sanic/pull/2979) Throw error on bad body length\n- [#2980](https://github.com/sanic-org/sanic/pull/2980) Throw error on bad body encoding\n\n### Deprecations and Removals\n- [#2899](https://github.com/sanic-org/sanic/pull/2899) Remove erroneous line from REPL impacting environments without HTTPX\n- [#2962](https://github.com/sanic-org/sanic/pull/2962) Merge entity header removal\n\n### Developer infrastructure\n- [#2882](https://github.com/sanic-org/sanic/pull/2882) [#2896](https://github.com/sanic-org/sanic/pull/2896) Apply dynamic port fixture for improving tests with port selection\n- [#2887](https://github.com/sanic-org/sanic/pull/2887) Updates to docker image builds\n- [#2932](https://github.com/sanic-org/sanic/pull/2932) Cleanup code base with Ruff\n\n### Improved Documentation\n- [#2924](https://github.com/sanic-org/sanic/pull/2924) Cleanup markdown on html5tagger page\n- [#2930](https://github.com/sanic-org/sanic/pull/2930) Cleanup typo on Sanic Extensions README.md\n- [#2934](https://github.com/sanic-org/sanic/pull/2934) Add more context to the health check documents\n- [#2936](https://github.com/sanic-org/sanic/pull/2936) Improve worker manager documentation\n- [#2955](https://github.com/sanic-org/sanic/pull/2955) Fixed wrong formatting in `request.md`\n\n## Version 23.12.0 🔷\n\n### Features\n- [#2775](https://github.com/sanic-org/sanic/pull/2775) Start and restart arbitrary processes\n- [#2811](https://github.com/sanic-org/sanic/pull/2811) Cleaner process management in shutdown\n- [#2812](https://github.com/sanic-org/sanic/pull/2812) Suppress task cancel traceback on open websocket\n- [#2822](https://github.com/sanic-org/sanic/pull/2822) Listener and signal prioritization\n- [#2831](https://github.com/sanic-org/sanic/pull/2831) Reduce memory consumption\n- [#2837](https://github.com/sanic-org/sanic/pull/2837) Accept bare cookies\n- [#2841](https://github.com/sanic-org/sanic/pull/2841) Add `websocket.handler.` signals\n- [#2805](https://github.com/sanic-org/sanic/pull/2805) Add changed files to reload trigger listeners\n- [#2813](https://github.com/sanic-org/sanic/pull/2813) Allow for simple signals\n- [#2827](https://github.com/sanic-org/sanic/pull/2827) Improve functionality and consistency of `Sanic.event()`\n- [#2851](https://github.com/sanic-org/sanic/pull/2851) Allow range requests for a single byte\n- [#2854](https://github.com/sanic-org/sanic/pull/2854) Better `Request.scheme` for websocket requests\n- [#2858](https://github.com/sanic-org/sanic/pull/2858) Convert Sanic `Request` to a Websockets `Request` for handshake\n- [#2859](https://github.com/sanic-org/sanic/pull/2859) Add a REPL to the `sanic` CLI\n- [#2870](https://github.com/sanic-org/sanic/pull/2870) Add Python 3.12 support\n- [#2875](https://github.com/sanic-org/sanic/pull/2875) Better exception on multiprocessing context conflicts\n\n### Bugfixes\n- [#2803](https://github.com/sanic-org/sanic/pull/2803) Fix MOTD display for extra data\n\n### Developer infrastructure\n- [#2796](https://github.com/sanic-org/sanic/pull/2796) Refactor unit test cases\n- [#2801](https://github.com/sanic-org/sanic/pull/2801) Fix `test_fast` when there is only one CPU\n- [#2807](https://github.com/sanic-org/sanic/pull/2807) Add constraint for autodocsum (lint issue in old package version)\n- [#2808](https://github.com/sanic-org/sanic/pull/2808) Refactor GitHub Actions\n- [#2814](https://github.com/sanic-org/sanic/pull/2814) Run CI pipeline on git push\n- [#2846](https://github.com/sanic-org/sanic/pull/2846) Drop old performance tests/benchmarks\n- [#2848](https://github.com/sanic-org/sanic/pull/2848) Makefile cleanup\n- [#2865](https://github.com/sanic-org/sanic/pull/2865)\n [#2869](https://github.com/sanic-org/sanic/pull/2869)\n [#2872](https://github.com/sanic-org/sanic/pull/2872)\n [#2879](https://github.com/sanic-org/sanic/pull/2879)\n Add ruff to toolchain\n- [#2866](https://github.com/sanic-org/sanic/pull/2866) Fix the alt svc test to run locally with explicit buffer nbytes\n- [#2877](https://github.com/sanic-org/sanic/pull/2877) Use Python's trusted publisher in deployments\n- [#2882](https://github.com/sanic-org/sanic/pull/2882) Introduce dynamic port fixture in targeted locations in the test suite\n\n### Improved Documentation\n- [#2781](https://github.com/sanic-org/sanic/pull/2781)\n [#2821](https://github.com/sanic-org/sanic/pull/2821)\n [#2861](https://github.com/sanic-org/sanic/pull/2861)\n [#2863](https://github.com/sanic-org/sanic/pull/2863)\n Conversion of User Guide to the SHH (Sanic, html5tagger, HTMX) stack\n- [#2810](https://github.com/sanic-org/sanic/pull/2810) Update README\n- [#2855](https://github.com/sanic-org/sanic/pull/2855) Edit Discord badge\n- [#2864](https://github.com/sanic-org/sanic/pull/2864) Adjust documentation for using state properties within http/https redirection document\n\n\n## Version 23.9.0\n\n_Due to circumstances at the time, v.23.9 was skipped._\n\n\n## Version 23.6.0\n\n### Features\n- [#2670](https://github.com/sanic-org/sanic/pull/2670) Increase `KEEP_ALIVE_TIMEOUT` default to 120 seconds\n- [#2716](https://github.com/sanic-org/sanic/pull/2716) Adding allow route overwrite option in blueprint\n- [#2724](https://github.com/sanic-org/sanic/pull/2724) and [#2792](https://github.com/sanic-org/sanic/pull/2792) Add a new exception signal for ALL exceptions raised anywhere in application\n- [#2727](https://github.com/sanic-org/sanic/pull/2727) Add name prefixing to BP groups\n- [#2754](https://github.com/sanic-org/sanic/pull/2754) Update request type on middleware types\n- [#2770](https://github.com/sanic-org/sanic/pull/2770) Better exception message on startup time application induced import error\n- [#2776](https://github.com/sanic-org/sanic/pull/2776) Set multiprocessing start method early\n- [#2785](https://github.com/sanic-org/sanic/pull/2785) Add custom typing to config and ctx objects\n- [#2790](https://github.com/sanic-org/sanic/pull/2790) Add `request.client_ip`\n\n### Bugfixes\n- [#2728](https://github.com/sanic-org/sanic/pull/2728) Fix traversals for intended results\n- [#2729](https://github.com/sanic-org/sanic/pull/2729) Handle case when headers argument of ResponseStream constructor is None\n- [#2737](https://github.com/sanic-org/sanic/pull/2737) Fix type annotation for `JSONREsponse` default content type\n- [#2740](https://github.com/sanic-org/sanic/pull/2740) Use Sanic's serializer for JSON responses in the Inspector\n- [#2760](https://github.com/sanic-org/sanic/pull/2760) Support for `Request.get_current` in ASGI mode\n- [#2773](https://github.com/sanic-org/sanic/pull/2773) Alow Blueprint routes to explicitly define error_format\n- [#2774](https://github.com/sanic-org/sanic/pull/2774) Resolve headers on different renderers\n- [#2782](https://github.com/sanic-org/sanic/pull/2782) Resolve pypy compatibility issues\n\n### Deprecations and Removals\n- [#2777](https://github.com/sanic-org/sanic/pull/2777) Remove Python 3.7 support\n\n### Developer infrastructure\n- [#2766](https://github.com/sanic-org/sanic/pull/2766) Unpin setuptools version\n- [#2779](https://github.com/sanic-org/sanic/pull/2779) Run keep alive tests in loop to get available port\n\n### Improved Documentation\n- [#2741](https://github.com/sanic-org/sanic/pull/2741) Better documentation examples about running Sanic\nFrom that list, the items to highlight in the release notes:\n\n\n## Version 23.3.0\n\n### Features\n- [#2545](https://github.com/sanic-org/sanic/pull/2545) Standardize init of exceptions for more consistent control of HTTP responses using exceptions\n- [#2606](https://github.com/sanic-org/sanic/pull/2606) Decode headers as UTF-8 also in ASGI\n- [#2646](https://github.com/sanic-org/sanic/pull/2646) Separate ASGI request and lifespan callables\n- [#2659](https://github.com/sanic-org/sanic/pull/2659) Use ``FALLBACK_ERROR_FORMAT`` for handlers that return ``empty()``\n- [#2662](https://github.com/sanic-org/sanic/pull/2662) Add basic file browser (HTML page) and auto-index serving\n- [#2667](https://github.com/sanic-org/sanic/pull/2667) Nicer traceback formatting (HTML page)\n- [#2668](https://github.com/sanic-org/sanic/pull/2668) Smarter error page rendering format selection; more reliant upon header and \"common sense\" defaults\n- [#2680](https://github.com/sanic-org/sanic/pull/2680) Check the status of socket before shutting down with ``SHUT_RDWR``\n- [#2687](https://github.com/sanic-org/sanic/pull/2687) Refresh ``Request.accept`` functionality to be more performant and spec-compliant\n- [#2696](https://github.com/sanic-org/sanic/pull/2696) Add header accessors as properties\n ```\n Example-Field: Foo, Bar\n Example-Field: Baz\n ```\n ```python\n request.headers.example_field == \"Foo, Bar,Baz\"\n ```\n- [#2700](https://github.com/sanic-org/sanic/pull/2700) Simpler CLI targets\n\n ```sh\n $ sanic path.to.module:app # global app instance\n $ sanic path.to.module:create_app # factory pattern\n $ sanic ./path/to/directory/ # simple serve\n ```\n- [#2701](https://github.com/sanic-org/sanic/pull/2701) API to define a number of workers in managed processes\n- [#2704](https://github.com/sanic-org/sanic/pull/2704) Add convenience for dynamic changes to routing\n- [#2706](https://github.com/sanic-org/sanic/pull/2706) Add convenience methods for cookie creation and deletion\n \n ```python\n response = text(\"...\")\n response.add_cookie(\"test\", \"It worked!\", domain=\".yummy-yummy-cookie.com\")\n ```\n- [#2707](https://github.com/sanic-org/sanic/pull/2707) Simplified ``parse_content_header`` escaping to be RFC-compliant and remove outdated FF hack\n- [#2710](https://github.com/sanic-org/sanic/pull/2710) Stricter charset handling and escaping of request URLs\n- [#2711](https://github.com/sanic-org/sanic/pull/2711) Consume body on ``DELETE`` by default\n- [#2719](https://github.com/sanic-org/sanic/pull/2719) Allow ``password`` to be passed to TLS context\n- [#2720](https://github.com/sanic-org/sanic/pull/2720) Skip middleware on ``RequestCancelled``\n- [#2721](https://github.com/sanic-org/sanic/pull/2721) Change access logging format to ``%s``\n- [#2722](https://github.com/sanic-org/sanic/pull/2722) Add ``CertLoader`` as application option for directly controlling ``SSLContext`` objects\n- [#2725](https://github.com/sanic-org/sanic/pull/2725) Worker sync state tolerance on race condition\n\n### Bugfixes\n- [#2651](https://github.com/sanic-org/sanic/pull/2651) ASGI websocket to pass thru bytes as is\n- [#2697](https://github.com/sanic-org/sanic/pull/2697) Fix comparison between datetime aware and naive in ``file`` when using ``If-Modified-Since``\n\n### Deprecations and Removals\n- [#2666](https://github.com/sanic-org/sanic/pull/2666) Remove deprecated ``__blueprintname__`` property\n\n### Improved Documentation\n- [#2712](https://github.com/sanic-org/sanic/pull/2712) Improved example using ``'https'`` to create the redirect\n\n\n## Version 22.12.0\n\n_Current LTS version_\n\n### Features\n\n- [#2569](https://github.com/sanic-org/sanic/pull/2569) Add `JSONResponse` class with some convenient methods when updating a response object\n- [#2598](https://github.com/sanic-org/sanic/pull/2598) Change `uvloop` requirement to `>=0.15.0`\n- [#2609](https://github.com/sanic-org/sanic/pull/2609) Add compatibility with `websockets` v11.0\n- [#2610](https://github.com/sanic-org/sanic/pull/2610) Kill server early on worker error\n - Raise deadlock timeout to 30s\n- [#2617](https://github.com/sanic-org/sanic/pull/2617) Scale number of running server workers\n- [#2621](https://github.com/sanic-org/sanic/pull/2621) [#2634](https://github.com/sanic-org/sanic/pull/2634) Send `SIGKILL` on subsequent `ctrl+c` to force worker exit\n- [#2622](https://github.com/sanic-org/sanic/pull/2622) Add API to restart all workers from the multiplexer\n- [#2624](https://github.com/sanic-org/sanic/pull/2624) Default to `spawn` for all subprocesses unless specifically set:\n ```python\n from sanic import Sanic\n \n Sanic.start_method = \"fork\"\n ```\n- [#2625](https://github.com/sanic-org/sanic/pull/2625) Filename normalisation of form-data/multipart file uploads\n- [#2626](https://github.com/sanic-org/sanic/pull/2626) Move to HTTP Inspector:\n - Remote access to inspect running Sanic instances\n - TLS support for encrypted calls to Inspector\n - Authentication to Inspector with API key\n - Ability to extend Inspector with custom commands\n- [#2632](https://github.com/sanic-org/sanic/pull/2632) Control order of restart operations\n- [#2633](https://github.com/sanic-org/sanic/pull/2633) Move reload interval to class variable\n- [#2636](https://github.com/sanic-org/sanic/pull/2636) Add `priority` to `register_middleware` method\n- [#2639](https://github.com/sanic-org/sanic/pull/2639) Add `unquote` to `add_route` method\n- [#2640](https://github.com/sanic-org/sanic/pull/2640) ASGI websockets to receive `text` or `bytes`\n\n\n### Bugfixes\n\n- [#2607](https://github.com/sanic-org/sanic/pull/2607) Force socket shutdown before close to allow rebinding\n- [#2590](https://github.com/sanic-org/sanic/pull/2590) Use actual `StrEnum` in Python 3.11+\n- [#2615](https://github.com/sanic-org/sanic/pull/2615) Ensure middleware executes only once per request timeout\n- [#2627](https://github.com/sanic-org/sanic/pull/2627) Crash ASGI application on lifespan failure\n- [#2635](https://github.com/sanic-org/sanic/pull/2635) Resolve error with low-level server creation on Windows\n\n\n### Deprecations and Removals\n\n- [#2608](https://github.com/sanic-org/sanic/pull/2608) [#2630](https://github.com/sanic-org/sanic/pull/2630) Signal conditions and triggers saved on `signal.extra` \n- [#2626](https://github.com/sanic-org/sanic/pull/2626) Move to HTTP Inspector\n - 🚨 *BREAKING CHANGE*: Moves the Inspector to a Sanic app from a simple TCP socket with a custom protocol\n - *DEPRECATE*: The `--inspect*` commands have been deprecated in favor of `inspect ...` commands\n- [#2628](https://github.com/sanic-org/sanic/pull/2628) Replace deprecated `distutils.strtobool`\n\n\n### Developer infrastructure\n\n- [#2612](https://github.com/sanic-org/sanic/pull/2612) Add CI testing for Python 3.11\n\n\n## Version 22.9.1\n\n### Features\n\n- [#2585](https://github.com/sanic-org/sanic/pull/2585) Improved error message when no applications have been registered\n\n\n### Bugfixes\n\n- [#2578](https://github.com/sanic-org/sanic/pull/2578) Add certificate loader for in process certificate creation\n- [#2591](https://github.com/sanic-org/sanic/pull/2591) Do not use sentinel identity for `spawn` compatibility\n- [#2592](https://github.com/sanic-org/sanic/pull/2592) Fix properties in nested blueprint groups\n- [#2595](https://github.com/sanic-org/sanic/pull/2595) Introduce sleep interval on new worker reloader\n\n\n### Deprecations and Removals\n\n\n### Developer infrastructure\n\n- [#2588](https://github.com/sanic-org/sanic/pull/2588) Markdown templates on issue forms\n\n\n### Improved Documentation\n\n- [#2556](https://github.com/sanic-org/sanic/pull/2556) v22.9 documentation\n- [#2582](https://github.com/sanic-org/sanic/pull/2582) Cleanup documentation on Windows support\n\n\n## Version 22.9.0\n\n### Features\n\n- [#2445](https://github.com/sanic-org/sanic/pull/2445) Add custom loads function \n- [#2490](https://github.com/sanic-org/sanic/pull/2490) Make `WebsocketImplProtocol` async iterable\n- [#2499](https://github.com/sanic-org/sanic/pull/2499) Sanic Server WorkerManager refactor\n- [#2506](https://github.com/sanic-org/sanic/pull/2506) Use `pathlib` for path resolution (for static file serving)\n- [#2508](https://github.com/sanic-org/sanic/pull/2508) Use `path.parts` instead of `match` (for static file serving)\n- [#2513](https://github.com/sanic-org/sanic/pull/2513) Better request cancel handling\n- [#2516](https://github.com/sanic-org/sanic/pull/2516) Add request properties for HTTP method info:\n - `request.is_safe`\n - `request.is_idempotent`\n - `request.is_cacheable`\n - *See* [MDN docs](https://developer.mozilla.org/en-US/docs/Web/HTTP/Methods) *for more information about when these apply*\n- [#2522](https://github.com/sanic-org/sanic/pull/2522) Always show server location in ASGI\n- [#2526](https://github.com/sanic-org/sanic/pull/2526) Cache control support for static files for returning 304 when appropriate\n- [#2533](https://github.com/sanic-org/sanic/pull/2533) Refactor `_static_request_handler`\n- [#2540](https://github.com/sanic-org/sanic/pull/2540) Add signals before and after handler execution\n - `http.handler.before`\n - `http.handler.after`\n- [#2542](https://github.com/sanic-org/sanic/pull/2542) Add *[redacted]* to CLI :)\n- [#2546](https://github.com/sanic-org/sanic/pull/2546) Add deprecation warning filter\n- [#2550](https://github.com/sanic-org/sanic/pull/2550) Middleware priority and performance enhancements\n\n### Bugfixes\n\n- [#2495](https://github.com/sanic-org/sanic/pull/2495) Prevent directory traversion with static files\n- [#2515](https://github.com/sanic-org/sanic/pull/2515) Do not apply double slash to paths in certain static dirs in Blueprints\n\n### Deprecations and Removals\n\n- [#2525](https://github.com/sanic-org/sanic/pull/2525) Warn on duplicate route names, will be prevented outright in v23.3\n- [#2537](https://github.com/sanic-org/sanic/pull/2537) Raise warning and deprecation notice on duplicate exceptions, will be prevented outright in v23.3\n\n### Developer infrastructure\n\n- [#2504](https://github.com/sanic-org/sanic/pull/2504) Cleanup test suite\n- [#2505](https://github.com/sanic-org/sanic/pull/2505) Replace Unsupported Python Version Number from the Contributing Doc\n- [#2530](https://github.com/sanic-org/sanic/pull/2530) Do not include tests folder in installed package resolver\n\n### Improved Documentation\n\n- [#2502](https://github.com/sanic-org/sanic/pull/2502) Fix a few typos\n- [#2517](https://github.com/sanic-org/sanic/pull/2517) [#2536](https://github.com/sanic-org/sanic/pull/2536) Add some type hints\n\n\n## Version 22.6.2\n\n### Bugfixes\n\n- [#2522](https://github.com/sanic-org/sanic/pull/2522) Always show server location in ASGI\n\n## Version 22.6.1\n\n### Bugfixes\n\n- [#2477](https://github.com/sanic-org/sanic/pull/2477) Sanic static directory fails when folder name ends with \"..\"\n\n\n## Version 22.6.0\n\n### Features\n- [#2378](https://github.com/sanic-org/sanic/pull/2378) Introduce HTTP/3 and autogeneration of TLS certificates in `DEBUG` mode\n - 👶 *EARLY RELEASE FEATURE*: Serving Sanic over HTTP/3 is an early release feature. It does not yet fully cover the HTTP/3 spec, but instead aims for feature parity with Sanic's existing HTTP/1.1 server. Websockets, WebTransport, push responses are examples of some features not yet implemented.\n - 📦 *EXTRA REQUIREMENT*: Not all HTTP clients are capable of interfacing with HTTP/3 servers. You may need to install a [HTTP/3 capable client](https://curl.se/docs/http3.html).\n - 📦 *EXTRA REQUIREMENT*: In order to use TLS autogeneration, you must install either [mkcert](https://github.com/FiloSottile/mkcert) or [trustme](https://github.com/python-trio/trustme).\n- [#2416](https://github.com/sanic-org/sanic/pull/2416) Add message to `task.cancel`\n- [#2420](https://github.com/sanic-org/sanic/pull/2420) Add exception aliases for more consistent naming with standard HTTP response types (`BadRequest`, `MethodNotAllowed`, `RangeNotSatisfiable`)\n- [#2432](https://github.com/sanic-org/sanic/pull/2432) Expose ASGI `scope` as a property on the `Request` object\n- [#2438](https://github.com/sanic-org/sanic/pull/2438) Easier access to websocket class for annotation: `from sanic import Websocket`\n- [#2439](https://github.com/sanic-org/sanic/pull/2439) New API for reading form values with options: `Request.get_form` \n- [#2445](https://github.com/sanic-org/sanic/pull/2445) Add custom `loads` function\n- [#2447](https://github.com/sanic-org/sanic/pull/2447), [#2486](https://github.com/sanic-org/sanic/pull/2486) Improved API to support setting cache control headers\n- [#2453](https://github.com/sanic-org/sanic/pull/2453) Move verbosity filtering to logger\n- [#2475](https://github.com/sanic-org/sanic/pull/2475) Expose getter for current request using `Request.get_current()`\n\n### Bugfixes\n- [#2448](https://github.com/sanic-org/sanic/pull/2448) Fix to allow running with `pythonw.exe` or places where there is no `sys.stdout`\n- [#2451](https://github.com/sanic-org/sanic/pull/2451) Trigger `http.lifecycle.request` signal in ASGI mode\n- [#2455](https://github.com/sanic-org/sanic/pull/2455) Resolve typing of stacked route definitions\n- [#2463](https://github.com/sanic-org/sanic/pull/2463) Properly catch websocket CancelledError in websocket handler in Python 3.7\n\n### Deprecations and Removals\n- [#2487](https://github.com/sanic-org/sanic/pull/2487) v22.6 deprecations and changes\n 1. Optional application registry\n 1. Execution of custom handlers after some part of response was sent\n 1. Configuring fallback handlers on the `ErrorHandler`\n 1. Custom `LOGO` setting\n 1. `sanic.response.stream`\n 1. `AsyncioServer.init`\n\n### Developer infrastructure\n- [#2449](https://github.com/sanic-org/sanic/pull/2449) Clean up `black` and `isort` config\n- [#2479](https://github.com/sanic-org/sanic/pull/2479) Fix some flappy tests\n\n### Improved Documentation\n- [#2461](https://github.com/sanic-org/sanic/pull/2461) Update example to match current application naming standards\n- [#2466](https://github.com/sanic-org/sanic/pull/2466) Better type annotation for `Extend`\n- [#2485](https://github.com/sanic-org/sanic/pull/2485) Improved help messages in CLI\n\n\n## Version 22.3.0\n\n### Features\n- [#2347](https://github.com/sanic-org/sanic/pull/2347) API for multi-application server\n - 🚨 *BREAKING CHANGE*: The old `sanic.worker.GunicornWorker` has been **removed**. To run Sanic with `gunicorn`, you should use it thru `uvicorn` [as described in their docs](https://www.uvicorn.org/#running-with-gunicorn).\n - 🧁 *SIDE EFFECT*: Named background tasks are now supported, even in Python 3.7\n- [#2357](https://github.com/sanic-org/sanic/pull/2357) Parse `Authorization` header as `Request.credentials`\n- [#2361](https://github.com/sanic-org/sanic/pull/2361) Add config option to skip `Touchup` step in application startup\n- [#2372](https://github.com/sanic-org/sanic/pull/2372) Updates to CLI help messaging\n- [#2382](https://github.com/sanic-org/sanic/pull/2382) Downgrade warnings to backwater debug messages \n- [#2396](https://github.com/sanic-org/sanic/pull/2396) Allow for `multidict` v0.6\n- [#2401](https://github.com/sanic-org/sanic/pull/2401) Upgrade CLI catching for alternative application run types\n- [#2402](https://github.com/sanic-org/sanic/pull/2402) Conditionally inject CLI arguments into factory\n- [#2413](https://github.com/sanic-org/sanic/pull/2413) Add new start and stop event listeners to reloader process\n- [#2414](https://github.com/sanic-org/sanic/pull/2414) Remove loop as required listener arg\n- [#2415](https://github.com/sanic-org/sanic/pull/2415) Better exception for bad URL parsing\n- [sanic-routing#47](https://github.com/sanic-org/sanic-routing/pull/47) Add a new extention parameter type: ``, ``, ``, ``, ``, ``\n - 👶 *BETA FEATURE*: This feature will not work with `path` type matching, and is being released as a beta feature only.\n- [sanic-routing#57](https://github.com/sanic-org/sanic-routing/pull/57) Change `register_pattern` to accept a `str` or `Pattern`\n- [sanic-routing#58](https://github.com/sanic-org/sanic-routing/pull/58) Default matching on non-empty strings only, and new `strorempty` pattern type\n - 🚨 *BREAKING CHANGE*: Previously a route with a dynamic string parameter (`/` or `/`) would match on any string, including empty strings. It will now **only** match a non-empty string. To retain the old behavior, you should use the new parameter type: `/`.\n\n### Bugfixes\n- [#2373](https://github.com/sanic-org/sanic/pull/2373) Remove `error_logger` on websockets\n- [#2381](https://github.com/sanic-org/sanic/pull/2381) Fix newly assigned `None` in task registry\n- [sanic-routing#52](https://github.com/sanic-org/sanic-routing/pull/52) Add type casting to regex route matching\n- [sanic-routing#60](https://github.com/sanic-org/sanic-routing/pull/60) Add requirements check on regex routes (this resolves, for example, multiple static directories with differing `host` values)\n\n### Deprecations and Removals\n- [#2362](https://github.com/sanic-org/sanic/pull/2362) 22.3 Deprecations and changes\n 1. `debug=True` and `--debug` do _NOT_ automatically run `auto_reload`\n 2. Default error render is with plain text (browsers still get HTML by default because `auto` looks at headers)\n 3. `config` is required for `ErrorHandler.finalize`\n 4. `ErrorHandler.lookup` requires two positional args\n 5. Unused websocket protocol args removed\n- [#2344](https://github.com/sanic-org/sanic/pull/2344) Deprecate loading of lowercase environment variables\n\n### Developer infrastructure\n- [#2363](https://github.com/sanic-org/sanic/pull/2363) Revert code coverage back to Codecov\n- [#2405](https://github.com/sanic-org/sanic/pull/2405) Upgrade tests for `sanic-routing` changes\n- [sanic-testing#35](https://github.com/sanic-org/sanic-testing/pull/35) Allow for httpx v0.22\n\n### Improved Documentation\n- [#2350](https://github.com/sanic-org/sanic/pull/2350) Fix link in README for ASGI\n- [#2398](https://github.com/sanic-org/sanic/pull/2398) Document middleware on_request and on_response\n- [#2409](https://github.com/sanic-org/sanic/pull/2409) Add missing documentation for `Request.respond`\n\n### Miscellaneous\n- [#2376](https://github.com/sanic-org/sanic/pull/2376) Fix typing for `ListenerMixin.listener`\n- [#2383](https://github.com/sanic-org/sanic/pull/2383) Clear deprecation warning in `asyncio.wait`\n- [#2387](https://github.com/sanic-org/sanic/pull/2387) Cleanup `__slots__` implementations\n- [#2390](https://github.com/sanic-org/sanic/pull/2390) Clear deprecation warning in `asyncio.get_event_loop`\n\n\n## Version 21.12.1\n\n- [#2349](https://github.com/sanic-org/sanic/pull/2349) Only display MOTD on startup\n- [#2354](https://github.com/sanic-org/sanic/pull/2354) Ignore name argument in Python 3.7\n- [#2355](https://github.com/sanic-org/sanic/pull/2355) Add config.update support for all config values\n\n## Version 21.12.0\n\n### Features\n- [#2260](https://github.com/sanic-org/sanic/pull/2260) Allow early Blueprint registrations to still apply later added objects\n- [#2262](https://github.com/sanic-org/sanic/pull/2262) Noisy exceptions - force logging of all exceptions\n- [#2264](https://github.com/sanic-org/sanic/pull/2264) Optional `uvloop` by configuration\n- [#2270](https://github.com/sanic-org/sanic/pull/2270) Vhost support using multiple TLS certificates\n- [#2277](https://github.com/sanic-org/sanic/pull/2277) Change signal routing for increased consistency\n - *BREAKING CHANGE*: If you were manually routing signals there is a breaking change. The signal router's `get` is no longer 100% determinative. There is now an additional step to loop thru the returned signals for proper matching on the requirements. If signals are being dispatched using `app.dispatch` or `bp.dispatch`, there is no change.\n- [#2290](https://github.com/sanic-org/sanic/pull/2290) Add contextual exceptions\n- [#2291](https://github.com/sanic-org/sanic/pull/2291) Increase join concat performance \n- [#2295](https://github.com/sanic-org/sanic/pull/2295), [#2316](https://github.com/sanic-org/sanic/pull/2316), [#2331](https://github.com/sanic-org/sanic/pull/2331) Restructure of CLI and application state with new displays and more command parity with `app.run`\n- [#2302](https://github.com/sanic-org/sanic/pull/2302) Add route context at definition time\n- [#2304](https://github.com/sanic-org/sanic/pull/2304) Named tasks and new API for managing background tasks\n- [#2307](https://github.com/sanic-org/sanic/pull/2307) On app auto-reload, provide insight of changed files\n- [#2308](https://github.com/sanic-org/sanic/pull/2308) Auto extend application with [Sanic Extensions](https://sanicframework.org/en/plugins/sanic-ext/getting-started.html) if it is installed, and provide first class support for accessing the extensions\n- [#2309](https://github.com/sanic-org/sanic/pull/2309) Builtin signals changed to `Enum`\n- [#2313](https://github.com/sanic-org/sanic/pull/2313) Support additional config implementation use case\n- [#2321](https://github.com/sanic-org/sanic/pull/2321) Refactor environment variable hydration logic\n- [#2327](https://github.com/sanic-org/sanic/pull/2327) Prevent sending multiple or mixed responses on a single request\n- [#2330](https://github.com/sanic-org/sanic/pull/2330) Custom type casting on environment variables\n- [#2332](https://github.com/sanic-org/sanic/pull/2332) Make all deprecation notices consistent\n- [#2335](https://github.com/sanic-org/sanic/pull/2335) Allow underscore to start instance names\n\n### Bugfixes\n- [#2273](https://github.com/sanic-org/sanic/pull/2273) Replace assignation by typing for `websocket_handshake`\n- [#2285](https://github.com/sanic-org/sanic/pull/2285) Fix IPv6 display in startup logs\n- [#2299](https://github.com/sanic-org/sanic/pull/2299) Dispatch `http.lifecyle.response` from exception handler\n\n### Deprecations and Removals\n- [#2306](https://github.com/sanic-org/sanic/pull/2306) Removal of deprecated items\n - `Sanic` and `Blueprint` may no longer have arbitrary properties attached to them\n - `Sanic` and `Blueprint` forced to have compliant names\n - alphanumeric + `_` + `-`\n - must start with letter or `_`\n - `load_env` keyword argument of `Sanic`\n - `sanic.exceptions.abort`\n - `sanic.views.CompositionView`\n - `sanic.response.StreamingHTTPResponse`\n - *NOTE:* the `stream()` response method (where you pass a callable streaming function) has been deprecated and will be removed in v22.6. You should upgrade all streaming responses to the new style: https://sanicframework.org/en/guide/advanced/streaming.html#response-streaming\n- [#2320](https://github.com/sanic-org/sanic/pull/2320) Remove app instance from Config for error handler setting\n\n### Developer infrastructure\n- [#2251](https://github.com/sanic-org/sanic/pull/2251) Change dev install command\n- [#2286](https://github.com/sanic-org/sanic/pull/2286) Change codeclimate complexity threshold from 5 to 10\n- [#2287](https://github.com/sanic-org/sanic/pull/2287) Update host test function names so they are not overwritten\n- [#2292](https://github.com/sanic-org/sanic/pull/2292) Fail CI on error\n- [#2311](https://github.com/sanic-org/sanic/pull/2311), [#2324](https://github.com/sanic-org/sanic/pull/2324) Do not run tests for draft PRs\n- [#2336](https://github.com/sanic-org/sanic/pull/2336) Remove paths from coverage checks\n- [#2338](https://github.com/sanic-org/sanic/pull/2338) Cleanup ports on tests\n\n### Improved Documentation\n- [#2269](https://github.com/sanic-org/sanic/pull/2269), [#2329](https://github.com/sanic-org/sanic/pull/2329), [#2333](https://github.com/sanic-org/sanic/pull/2333) Cleanup typos and fix language\n\n### Miscellaneous\n- [#2257](https://github.com/sanic-org/sanic/pull/2257), [#2294](https://github.com/sanic-org/sanic/pull/2294), [#2341](https://github.com/sanic-org/sanic/pull/2341) Add Python 3.10 support\n- [#2279](https://github.com/sanic-org/sanic/pull/2279), [#2317](https://github.com/sanic-org/sanic/pull/2317), [#2322](https://github.com/sanic-org/sanic/pull/2322) Add/correct missing type annotations\n- [#2305](https://github.com/sanic-org/sanic/pull/2305) Fix examples to use modern implementations\n\n\n## Version 21.9.3\n*Rerelease of v21.9.2 with some cleanup*\n\n## Version 21.9.2\n- [#2268](https://github.com/sanic-org/sanic/pull/2268) Make HTTP connections start in IDLE stage, avoiding delays and error messages\n- [#2310](https://github.com/sanic-org/sanic/pull/2310) More consistent config setting with post-FALLBACK_ERROR_FORMAT apply\n\n## Version 21.9.1\n- [#2259](https://github.com/sanic-org/sanic/pull/2259) Allow non-conforming ErrorHandlers\n\n## Version 21.9.0\n\n### Features\n- [#2158](https://github.com/sanic-org/sanic/pull/2158), [#2248](https://github.com/sanic-org/sanic/pull/2248) Complete overhaul of I/O to websockets\n- [#2160](https://github.com/sanic-org/sanic/pull/2160) Add new 17 signals into server and request lifecycles\n- [#2162](https://github.com/sanic-org/sanic/pull/2162) Smarter `auto` fallback formatting upon exception\n- [#2184](https://github.com/sanic-org/sanic/pull/2184) Introduce implementation for copying a Blueprint\n- [#2200](https://github.com/sanic-org/sanic/pull/2200) Accept header parsing\n- [#2207](https://github.com/sanic-org/sanic/pull/2207) Log remote address if available\n- [#2209](https://github.com/sanic-org/sanic/pull/2209) Add convenience methods to BP groups\n- [#2216](https://github.com/sanic-org/sanic/pull/2216) Add default messages to SanicExceptions\n- [#2225](https://github.com/sanic-org/sanic/pull/2225) Type annotation convenience for annotated handlers with path parameters\n- [#2236](https://github.com/sanic-org/sanic/pull/2236) Allow Falsey (but not-None) responses from route handlers\n- [#2238](https://github.com/sanic-org/sanic/pull/2238) Add `exception` decorator to Blueprint Groups\n- [#2244](https://github.com/sanic-org/sanic/pull/2244) Explicit static directive for serving file or dir (ex: `static(..., resource_type=\"file\")`)\n- [#2245](https://github.com/sanic-org/sanic/pull/2245) Close HTTP loop when connection task cancelled\n\n### Bugfixes\n- [#2188](https://github.com/sanic-org/sanic/pull/2188) Fix the handling of the end of a chunked request\n- [#2195](https://github.com/sanic-org/sanic/pull/2195) Resolve unexpected error handling on static requests\n- [#2208](https://github.com/sanic-org/sanic/pull/2208) Make blueprint-based exceptions attach and trigger in a more intuitive manner\n- [#2211](https://github.com/sanic-org/sanic/pull/2211) Fixed for handling exceptions of asgi app call\n- [#2213](https://github.com/sanic-org/sanic/pull/2213) Fix bug where ws exceptions not being logged\n- [#2231](https://github.com/sanic-org/sanic/pull/2231) Cleaner closing of tasks by using `abort()` in strategic places to avoid dangling sockets\n- [#2247](https://github.com/sanic-org/sanic/pull/2247) Fix logging of auto-reload status in debug mode\n- [#2246](https://github.com/sanic-org/sanic/pull/2246) Account for BP with exception handler but no routes\n\n### Developer infrastructure \n- [#2194](https://github.com/sanic-org/sanic/pull/2194) HTTP unit tests with raw client\n- [#2199](https://github.com/sanic-org/sanic/pull/2199) Switch to codeclimate\n- [#2214](https://github.com/sanic-org/sanic/pull/2214) Try Reopening Windows Tests\n- [#2229](https://github.com/sanic-org/sanic/pull/2229) Refactor `HttpProtocol` into a base class\n- [#2230](https://github.com/sanic-org/sanic/pull/2230) Refactor `server.py` into multi-file module\n\n### Miscellaneous\n- [#2173](https://github.com/sanic-org/sanic/pull/2173) Remove Duplicated Dependencies and PEP 517 Support \n- [#2193](https://github.com/sanic-org/sanic/pull/2193), [#2196](https://github.com/sanic-org/sanic/pull/2196), [#2217](https://github.com/sanic-org/sanic/pull/2217) Type annotation changes\n\n\n## Version 21.6.1\n\n**Bugfixes**\n\n- [#2178](https://github.com/sanic-org/sanic/pull/2178) Update\n sanic-routing to allow for better splitting of complex URI\n templates\n- [#2183](https://github.com/sanic-org/sanic/pull/2183) Proper\n handling of chunked request bodies to resolve phantom 503 in logs\n- [#2181](https://github.com/sanic-org/sanic/pull/2181) Resolve\n regression in exception logging\n- [#2201](https://github.com/sanic-org/sanic/pull/2201) Cleanup\n request info in pipelined requests\n\n## Version 21.6.0\n\n**Features**\n\n- [#2094](https://github.com/sanic-org/sanic/pull/2094) Add\n `response.eof()` method for closing a stream in a handler\n\n- [#2097](https://github.com/sanic-org/sanic/pull/2097) Allow\n case-insensitive HTTP Upgrade header\n\n- [#2104](https://github.com/sanic-org/sanic/pull/2104) Explicit\n usage of CIMultiDict getters\n\n- [#2109](https://github.com/sanic-org/sanic/pull/2109) Consistent\n use of error loggers\n\n- [#2114](https://github.com/sanic-org/sanic/pull/2114) New\n `client_ip` access of connection info instance\n\n- [#2119](https://github.com/sanic-org/sanic/pull/2119) Alternatate\n classes on instantiation for `Config` and `Sanic.ctx`\n\n- [#2133](https://github.com/sanic-org/sanic/pull/2133) Implement\n new version of AST router\n\n - Proper differentiation between `alpha` and `string` param\n types\n - Adds a `slug` param type, example: ``\n - Deprecates `` in favor of ``\n - Deprecates `` in favor of ``\n - Adds a `route.uri` accessor\n\n- [#2136](https://github.com/sanic-org/sanic/pull/2136) CLI\n improvements with new optional params\n\n- [#2137](https://github.com/sanic-org/sanic/pull/2137) Add\n `version_prefix` to URL builders\n\n- [#2140](https://github.com/sanic-org/sanic/pull/2140) Event\n autoregistration with `EVENT_AUTOREGISTER`\n\n- [#2146](https://github.com/sanic-org/sanic/pull/2146),\n [#2147](https://github.com/sanic-org/sanic/pull/2147) Require\n stricter names on `Sanic()` and `Blueprint()`\n\n- [#2150](https://github.com/sanic-org/sanic/pull/2150) Infinitely\n reusable and nestable `Blueprint` and `BlueprintGroup`\n\n- [#2154](https://github.com/sanic-org/sanic/pull/2154) Upgrade\n `websockets` dependency to min version\n\n- [#2155](https://github.com/sanic-org/sanic/pull/2155) Allow for\n maximum header sizes to be increased: `REQUEST_MAX_HEADER_SIZE`\n\n- [#2157](https://github.com/sanic-org/sanic/pull/2157) Allow app\n factory pattern in CLI\n\n- [#2165](https://github.com/sanic-org/sanic/pull/2165) Change HTTP\n methods to enums\n\n- [#2167](https://github.com/sanic-org/sanic/pull/2167) Allow\n auto-reloading on additional directories\n\n- [#2168](https://github.com/sanic-org/sanic/pull/2168) Add simple\n HTTP server to CLI\n\n- [#2170](https://github.com/sanic-org/sanic/pull/2170) Additional\n methods for attaching `HTTPMethodView`\n\n**Bugfixes**\n\n- [#2091](https://github.com/sanic-org/sanic/pull/2091) Fix\n `UserWarning` in ASGI mode for missing `__slots__`\n- [#2099](https://github.com/sanic-org/sanic/pull/2099) Fix static\n request handler logging exception on 404\n- [#2110](https://github.com/sanic-org/sanic/pull/2110) Fix\n request.args.pop removes parameters inconsistently\n- [#2107](https://github.com/sanic-org/sanic/pull/2107) Fix type\n hinting for load_env\n- [#2127](https://github.com/sanic-org/sanic/pull/2127) Make sure\n ASGI ws subprotocols is a list\n- [#2128](https://github.com/sanic-org/sanic/pull/2128) Fix issue\n where Blueprint exception handlers do not consistently route to\n proper handler\n\n**Deprecations and Removals**\n\n- [#2156](https://github.com/sanic-org/sanic/pull/2156) Remove\n config value `REQUEST_BUFFER_QUEUE_SIZE`\n- [#2170](https://github.com/sanic-org/sanic/pull/2170)\n `CompositionView` deprecated and marked for removal in 21.12\n- [#2172](https://github.com/sanic-org/sanic/pull/2170) Deprecate\n StreamingHTTPResponse\n\n**Developer infrastructure**\n\n- [#2149](https://github.com/sanic-org/sanic/pull/2149) Remove\n Travis CI in favor of GitHub Actions\n\n**Improved Documentation**\n\n- [#2164](https://github.com/sanic-org/sanic/pull/2164) Fix typo in\n documentation\n- [#2100](https://github.com/sanic-org/sanic/pull/2100) Remove\n documentation for non-existent arguments\n\n## Version 21.3.2\n\n**Bugfixes**\n\n- [#2081](https://github.com/sanic-org/sanic/pull/2081) Disable\n response timeout on websocket connections\n- [#2085](https://github.com/sanic-org/sanic/pull/2085) Make sure\n that blueprints with no slash is maintained when applied\n\n## Version 21.3.1\n\n**Bugfixes**\n\n- [#2076](https://github.com/sanic-org/sanic/pull/2076) Static files\n inside subfolders are not accessible (404)\n\n## Version 21.3.0\n\n[Release\nNotes](https://sanicframework.org/en/guide/release-notes/v21.3.html)\n\n**Features**\n\n- [#1876](https://github.com/sanic-org/sanic/pull/1876) Unified\n streaming server\n- [#2005](https://github.com/sanic-org/sanic/pull/2005) New\n `Request.id` property\n- [#2008](https://github.com/sanic-org/sanic/pull/2008) Allow\n Pathlib Path objects to be passed to `app.static()` helper\n- [#2010](https://github.com/sanic-org/sanic/pull/2010),\n [#2031](https://github.com/sanic-org/sanic/pull/2031) New\n startup-optimized router\n- [#2018](https://github.com/sanic-org/sanic/pull/2018)\n [#2064](https://github.com/sanic-org/sanic/pull/2064) Listeners\n for main server process\n- [#2032](https://github.com/sanic-org/sanic/pull/2032) Add raw\n header info to request object\n- [#2042](https://github.com/sanic-org/sanic/pull/2042)\n [#2060](https://github.com/sanic-org/sanic/pull/2060)\n [#2061](https://github.com/sanic-org/sanic/pull/2061) Introduce\n Signals API\n- [#2043](https://github.com/sanic-org/sanic/pull/2043) Add\n `__str__` and `__repr__` to Sanic and Blueprint\n- [#2047](https://github.com/sanic-org/sanic/pull/2047) Enable\n versioning and strict slash on BlueprintGroup\n- [#2053](https://github.com/sanic-org/sanic/pull/2053) Make\n `get_app` name argument optional\n- [#2055](https://github.com/sanic-org/sanic/pull/2055) JSON encoder\n change via app\n- [#2063](https://github.com/sanic-org/sanic/pull/2063) App and\n connection level context objects\n\n**Bugfixes**\n\n- Resolve [#1420](https://github.com/sanic-org/sanic/pull/1420)\n `url_for` where `strict_slashes` are on for a path ending in `/`\n- Resolve [#1525](https://github.com/sanic-org/sanic/pull/1525)\n Routing is incorrect with some special characters\n- Resolve [#1653](https://github.com/sanic-org/sanic/pull/1653) ASGI\n headers in body\n- Resolve [#1722](https://github.com/sanic-org/sanic/pull/1722)\n Using curl in chunk mode\n- Resolve [#1730](https://github.com/sanic-org/sanic/pull/1730)\n Extra content in ASGI streaming response\n- Resolve [#1749](https://github.com/sanic-org/sanic/pull/1749)\n Restore broken middleware edge cases\n- Resolve [#1785](https://github.com/sanic-org/sanic/pull/1785)\n [#1804](https://github.com/sanic-org/sanic/pull/1804) Synchronous\n error handlers\n- Resolve [#1790](https://github.com/sanic-org/sanic/pull/1790)\n Protocol errors did not support async error handlers #1790\n- Resolve [#1824](https://github.com/sanic-org/sanic/pull/1824)\n Timeout on specific methods\n- Resolve [#1875](https://github.com/sanic-org/sanic/pull/1875)\n Response timeout error from all routes after returning several\n timeouts from a specific route\n- Resolve [#1988](https://github.com/sanic-org/sanic/pull/1988)\n Handling of safe methods with body\n- [#2001](https://github.com/sanic-org/sanic/pull/2001) Raise\n ValueError when cookie max-age is not an integer\n\n**Deprecations and Removals**\n\n- [#2007](https://github.com/sanic-org/sanic/pull/2007) \\* Config\n using `from_envvar` \\* Config using `from_pyfile` \\* Config using\n `from_object`\n- [#2009](https://github.com/sanic-org/sanic/pull/2009) Remove Sanic\n test client to its own package\n- [#2036](https://github.com/sanic-org/sanic/pull/2036),\n [#2037](https://github.com/sanic-org/sanic/pull/2037) Drop Python\n 3.6 support\n- `Request.endpoint` deprecated in favor of `Request.name`\n- handler type name prefixes removed (static, websocket, etc)\n\n**Developer infrastructure**\n\n- [#1995](https://github.com/sanic-org/sanic/pull/1995) Create\n FUNDING.yml\n- [#2013](https://github.com/sanic-org/sanic/pull/2013) Add codeql\n to CI pipeline\n- [#2038](https://github.com/sanic-org/sanic/pull/2038) Codecov\n configuration updates\n- [#2049](https://github.com/sanic-org/sanic/pull/2049) Updated\n setup.py to use `find_packages`\n\n**Improved Documentation**\n\n- [#1218](https://github.com/sanic-org/sanic/pull/1218)\n Documentation for sanic.log.\\* is missing\n- [#1608](https://github.com/sanic-org/sanic/pull/1608) Add\n documentation on calver and LTS\n- [#1731](https://github.com/sanic-org/sanic/pull/1731) Support\n mounting application elsewhere than at root path\n- [#2006](https://github.com/sanic-org/sanic/pull/2006) Upgraded\n type annotations and improved docstrings and API documentation\n- [#2052](https://github.com/sanic-org/sanic/pull/2052) Fix some\n examples and docs\n\n**Miscellaneous**\n\n- `Request.route` property\n- Better websocket subprotocols support\n- Resolve bug with middleware in Blueprint Group when passed\n callable\n- Moves common logic between Blueprint and Sanic into mixins\n- Route naming changed to be more consistent\n - request endpoint is the route name\n - route names are fully namespaced\n- Some new convenience decorators:\n - `@app.main_process_start`\n - `@app.main_process_stop`\n - `@app.before_server_start`\n - `@app.after_server_start`\n - `@app.before_server_stop`\n - `@app.after_server_stop`\n - `@app.on_request`\n - `@app.on_response`\n- Fixes `Allow` header that did not include `HEAD`\n- Using \\\"name\\\" keyword in `url_for` for a \\\"static\\\" route where\n name does not exist\n- Cannot have multiple `app.static()` without using the named param\n- Using \\\"filename\\\" keyword in `url_for` on a file route\n- `unquote` in route def (not automatic)\n- `routes_all` is tuples\n- Handler arguments are kwarg only\n- `request.match_info` is now a cached (and not computed) property\n- Unknown static file mimetype is sent as `application/octet-stream`\n- `_host` keyword in `url_for`\n- Add charset default to `utf-8` for text and js content types if\n not specified\n- Version for a route can be str, float, or int\n- Route has ctx property\n- App has `routes_static`, `routes_dynamic`, `routes_regex`\n- [#2044](https://github.com/sanic-org/sanic/pull/2044) Code cleanup\n and refactoring\n- [#2072](https://github.com/sanic-org/sanic/pull/2072) Remove\n `BaseSanic` metaclass\n- [#2074](https://github.com/sanic-org/sanic/pull/2074) Performance\n adjustments in `handle_request_`\n\n## Version 20.12.3\n\n**Bugfixes**\n\n- [#2021](https://github.com/sanic-org/sanic/pull/2021) Remove\n prefix from websocket handler name\n\n## Version 20.12.2\n\n**Dependencies**\n\n- [#2026](https://github.com/sanic-org/sanic/pull/2026) Fix uvloop\n to 0.14 because 0.15 drops Python 3.6 support\n- [#2029](https://github.com/sanic-org/sanic/pull/2029) Remove old\n chardet requirement, add in hard multidict requirement\n\n## Version 19.12.5\n\n**Dependencies**\n\n- [#2025](https://github.com/sanic-org/sanic/pull/2025) Fix uvloop\n to 0.14 because 0.15 drops Python 3.6 support\n- [#2027](https://github.com/sanic-org/sanic/pull/2027) Remove old\n chardet requirement, add in hard multidict requirement\n\n## Version 20.12.0\n\n**Features**\n\n- [#1993](https://github.com/sanic-org/sanic/pull/1993) Add disable\n app registry\n- [#1945](https://github.com/sanic-org/sanic/pull/1945) Static route\n more verbose if file not found\n- [#1954](https://github.com/sanic-org/sanic/pull/1954) Fix static\n routes registration on a blueprint\n- [#1961](https://github.com/sanic-org/sanic/pull/1961) Add Python\n 3.9 support\n- [#1962](https://github.com/sanic-org/sanic/pull/1962) Sanic CLI\n upgrade\n- [#1967](https://github.com/sanic-org/sanic/pull/1967) Update\n aiofile version requirements\n- [#1969](https://github.com/sanic-org/sanic/pull/1969) Update\n multidict version requirements\n- [#1970](https://github.com/sanic-org/sanic/pull/1970) Add py.typed\n file\n- [#1972](https://github.com/sanic-org/sanic/pull/1972) Speed\n optimization in request handler\n- [#1979](https://github.com/sanic-org/sanic/pull/1979) Add app\n registry and Sanic class level app retrieval\n\n**Bugfixes**\n\n- [#1965](https://github.com/sanic-org/sanic/pull/1965) Fix Chunked\n Transport-Encoding in ASGI streaming response\n\n**Deprecations and Removals**\n\n- [#1981](https://github.com/sanic-org/sanic/pull/1981) Cleanup and\n remove deprecated code\n\n**Developer infrastructure**\n\n- [#1956](https://github.com/sanic-org/sanic/pull/1956) Fix load\n module test\n- [#1973](https://github.com/sanic-org/sanic/pull/1973) Transition\n Travis from .org to .com\n- [#1986](https://github.com/sanic-org/sanic/pull/1986) Update tox\n requirements\n\n**Improved Documentation**\n\n- [#1951](https://github.com/sanic-org/sanic/pull/1951)\n Documentation improvements\n- [#1983](https://github.com/sanic-org/sanic/pull/1983) Remove\n duplicate contents in testing.rst\n- [#1984](https://github.com/sanic-org/sanic/pull/1984) Fix typo in\n routing.rst\n\n## Version 20.9.1\n\n**Bugfixes**\n\n- [#1954](https://github.com/sanic-org/sanic/pull/1954) Fix static\n route registration on blueprints\n- [#1957](https://github.com/sanic-org/sanic/pull/1957) Removes\n duplicate headers in ASGI streaming body\n\n## Version 19.12.3\n\n**Bugfixes**\n\n- [#1959](https://github.com/sanic-org/sanic/pull/1959) Removes\n duplicate headers in ASGI streaming body\n\n## Version 20.9.0\n\n**Features**\n\n- [#1887](https://github.com/sanic-org/sanic/pull/1887) Pass\n subprotocols in websockets (both sanic server and ASGI)\n- [#1894](https://github.com/sanic-org/sanic/pull/1894)\n Automatically set `test_mode` flag on app instance\n- [#1903](https://github.com/sanic-org/sanic/pull/1903) Add new\n unified method for updating app values\n- [#1906](https://github.com/sanic-org/sanic/pull/1906),\n [#1909](https://github.com/sanic-org/sanic/pull/1909) Adds\n WEBSOCKET_PING_TIMEOUT and WEBSOCKET_PING_INTERVAL configuration\n values\n- [#1935](https://github.com/sanic-org/sanic/pull/1935) httpx\n version dependency updated, it is slated for removal as a\n dependency in v20.12\n- [#1937](https://github.com/sanic-org/sanic/pull/1937) Added auto,\n text, and json fallback error handlers (in v21.3, the default will\n change form html to auto)\n\n**Bugfixes**\n\n- [#1897](https://github.com/sanic-org/sanic/pull/1897) Resolves\n exception from unread bytes in stream\n\n**Deprecations and Removals**\n\n- [#1903](https://github.com/sanic-org/sanic/pull/1903)\n config.from_envar, config.from_pyfile, and config.from_object are\n deprecated and set to be removed in v21.3\n\n**Developer infrastructure**\n\n- [#1890](https://github.com/sanic-org/sanic/pull/1890),\n [#1891](https://github.com/sanic-org/sanic/pull/1891) Update isort\n calls to be compatible with new API\n- [#1893](https://github.com/sanic-org/sanic/pull/1893) Remove\n version section from setup.cfg\n- [#1924](https://github.com/sanic-org/sanic/pull/1924) Adding\n \\--strict-markers for pytest\n\n**Improved Documentation**\n\n- [#1922](https://github.com/sanic-org/sanic/pull/1922) Add explicit\n ASGI compliance to the README\n\n## Version 20.6.3\n\n**Bugfixes**\n\n- [#1884](https://github.com/sanic-org/sanic/pull/1884) Revert\n change to multiprocessing mode\n\n## Version 20.6.2\n\n**Features**\n\n- [#1641](https://github.com/sanic-org/sanic/pull/1641) Socket\n binding implemented properly for IPv6 and UNIX sockets\n\n## Version 20.6.1\n\n**Features**\n\n- [#1760](https://github.com/sanic-org/sanic/pull/1760) Add version\n parameter to websocket routes\n- [#1866](https://github.com/sanic-org/sanic/pull/1866) Add `sanic`\n as an entry point command\n- [#1880](https://github.com/sanic-org/sanic/pull/1880) Add handler\n names for websockets for url_for usage\n\n**Bugfixes**\n\n- [#1776](https://github.com/sanic-org/sanic/pull/1776) Bug fix for\n host parameter issue with lists\n- [#1842](https://github.com/sanic-org/sanic/pull/1842) Fix static\n \\_handler pickling error\n- [#1827](https://github.com/sanic-org/sanic/pull/1827) Fix reloader\n on OSX py38 and Windows\n- [#1848](https://github.com/sanic-org/sanic/pull/1848) Reverse\n named_response_middlware execution order, to match normal response\n middleware execution order\n- [#1853](https://github.com/sanic-org/sanic/pull/1853) Fix pickle\n error when attempting to pickle an application which contains\n websocket routes\n\n**Deprecations and Removals**\n\n- [#1739](https://github.com/sanic-org/sanic/pull/1739) Deprecate\n body_bytes to merge into body\n\n**Developer infrastructure**\n\n- [#1852](https://github.com/sanic-org/sanic/pull/1852) Fix naming\n of CI test env on Python nightlies\n- [#1857](https://github.com/sanic-org/sanic/pull/1857) Adjust\n websockets version to setup.py\n- [#1869](https://github.com/sanic-org/sanic/pull/1869) Wrap\n run()\\'s \\\"protocol\\\" type annotation in Optional\\[\\]\n\n**Improved Documentation**\n\n- [#1846](https://github.com/sanic-org/sanic/pull/1846) Update docs\n to clarify response middleware execution order\n- [#1865](https://github.com/sanic-org/sanic/pull/1865) Fixing rst\n format issue that was hiding documentation\n\n## Version 20.6.0\n\n*Released, but unintentionally omitting PR #1880, so was replaced by\n20.6.1*\n\n## Version 20.3.0\n\n**Features**\n\n- [#1762](https://github.com/sanic-org/sanic/pull/1762) Add\n `srv.start_serving()` and `srv.serve_forever()` to `AsyncioServer`\n- [#1767](https://github.com/sanic-org/sanic/pull/1767) Make Sanic\n usable on `hypercorn -k trio myweb.app`\n- [#1768](https://github.com/sanic-org/sanic/pull/1768) No\n tracebacks on normal errors and prettier error pages\n- [#1769](https://github.com/sanic-org/sanic/pull/1769) Code cleanup\n in file responses\n- [#1793](https://github.com/sanic-org/sanic/pull/1793) and\n [#1819](https://github.com/sanic-org/sanic/pull/1819) Upgrade\n `str.format()` to f-strings\n- [#1798](https://github.com/sanic-org/sanic/pull/1798) Allow\n multiple workers on MacOS with Python 3.8\n- [#1820](https://github.com/sanic-org/sanic/pull/1820) Do not set\n content-type and content-length headers in exceptions\n\n**Bugfixes**\n\n- [#1748](https://github.com/sanic-org/sanic/pull/1748) Remove loop\n argument in `asyncio.Event` in Python 3.8\n- [#1764](https://github.com/sanic-org/sanic/pull/1764) Allow route\n decorators to stack up again\n- [#1789](https://github.com/sanic-org/sanic/pull/1789) Fix tests\n using hosts yielding incorrect `url_for`\n- [#1808](https://github.com/sanic-org/sanic/pull/1808) Fix Ctrl+C\n and tests on Windows\n\n**Deprecations and Removals**\n\n- [#1800](https://github.com/sanic-org/sanic/pull/1800) Begin\n deprecation in way of first-class streaming, removal of\n `body_init`, `body_push`, and `body_finish`\n- [#1801](https://github.com/sanic-org/sanic/pull/1801) Complete\n deprecation from\n [#1666](https://github.com/sanic-org/sanic/pull/1666) of\n dictionary context on `request` objects.\n- [#1807](https://github.com/sanic-org/sanic/pull/1807) Remove\n server config args that can be read directly from app\n- [#1818](https://github.com/sanic-org/sanic/pull/1818) Complete\n deprecation of `app.remove_route` and `request.raw_args`\n\n**Dependencies**\n\n- [#1794](https://github.com/sanic-org/sanic/pull/1794) Bump `httpx`\n to 0.11.1\n- [#1806](https://github.com/sanic-org/sanic/pull/1806) Import\n `ASGIDispatch` from top-level `httpx` (from third-party\n deprecation)\n\n**Developer infrastructure**\n\n- [#1833](https://github.com/sanic-org/sanic/pull/1833) Resolve\n broken documentation builds\n\n**Improved Documentation**\n\n- [#1755](https://github.com/sanic-org/sanic/pull/1755) Usage of\n `response.empty()`\n- [#1778](https://github.com/sanic-org/sanic/pull/1778) Update\n README\n- [#1783](https://github.com/sanic-org/sanic/pull/1783) Fix typo\n- [#1784](https://github.com/sanic-org/sanic/pull/1784) Corrected\n changelog for docs move of MD to RST\n ([#1691](https://github.com/sanic-org/sanic/pull/1691))\n- [#1803](https://github.com/sanic-org/sanic/pull/1803) Update\n config docs to match DEFAULT_CONFIG\n- [#1814](https://github.com/sanic-org/sanic/pull/1814) Update\n getting_started.rst\n- [#1821](https://github.com/sanic-org/sanic/pull/1821) Update to\n deployment\n- [#1822](https://github.com/sanic-org/sanic/pull/1822) Update docs\n with changes done in 20.3\n- [#1834](https://github.com/sanic-org/sanic/pull/1834) Order of\n listeners\n\n## Version 19.12.0\n\n**Bugfixes**\n\n- Fix blueprint middleware application\n\n Currently, any blueprint middleware registered, irrespective of\n which blueprint was used to do so, was being applied to all of the\n routes created by the `@app` and `@blueprint` alike.\n\n As part of this change, the blueprint based middleware application\n is enforced based on where they are registered.\n\n - If you register a middleware via `@blueprint.middleware` then it\n will apply only to the routes defined by the blueprint.\n - If you register a middleware via `@blueprint_group.middleware`\n then it will apply to all blueprint based routes that are part\n of the group.\n - If you define a middleware via `@app.middleware` then it will be\n applied on all available routes\n ([#37](https://github.com/sanic-org/sanic/issues/37))\n\n- Fix [url_for]{.title-ref} behavior with missing SERVER_NAME\n\n If the [SERVER_NAME]{.title-ref} was missing in the\n [app.config]{.title-ref} entity, the [url_for]{.title-ref} on the\n [request]{.title-ref} and [app]{.title-ref} were failing due to an\n [AttributeError]{.title-ref}. This fix makes the availability of\n [SERVER_NAME]{.title-ref} on our [app.config]{.title-ref} an\n optional behavior.\n ([#1707](https://github.com/sanic-org/sanic/issues/1707))\n\n**Improved Documentation**\n\n- Move docs from MD to RST\n\n Moved all docs from markdown to restructured text like the rest of\n the docs to unify the scheme and make it easier in the future to\n update documentation.\n ([#1691](https://github.com/sanic-org/sanic/issues/1691))\n\n- Fix documentation for [get]{.title-ref} and [getlist]{.title-ref} of\n the [request.args]{.title-ref}\n\n Add additional example for showing the usage of\n [getlist]{.title-ref} and fix the documentation string for\n [request.args]{.title-ref} behavior\n ([#1704](https://github.com/sanic-org/sanic/issues/1704))\n\n## Version 19.6.3\n\n**Features**\n\n- Enable Towncrier Support\n\n As part of this feature, [towncrier]{.title-ref} is being introduced\n as a mechanism to partially automate the process of generating and\n managing change logs as part of each of pull requests.\n ([#1631](https://github.com/sanic-org/sanic/issues/1631))\n\n**Improved Documentation**\n\n- Documentation infrastructure changes\n - Enable having a single common [CHANGELOG]{.title-ref} file for\n both GitHub page and documentation\n - Fix Sphinix deprecation warnings\n - Fix documentation warnings due to invalid [rst]{.title-ref}\n indentation\n - Enable common contribution guidelines file across GitHub and\n documentation via [CONTRIBUTING.rst]{.title-ref}\n ([#1631](https://github.com/sanic-org/sanic/issues/1631))\n\n## Version 19.6.2\n\n**Features**\n\n- [#1562](https://github.com/sanic-org/sanic/pull/1562) Remove\n `aiohttp` dependency and create new `SanicTestClient` based upon\n [requests-async](https://github.com/encode/requests-async)\n- [#1475](https://github.com/sanic-org/sanic/pull/1475) Added ASGI\n support (Beta)\n- [#1436](https://github.com/sanic-org/sanic/pull/1436) Add\n Configure support from object string\n\n**Bugfixes**\n\n- [#1587](https://github.com/sanic-org/sanic/pull/1587) Add missing\n handle for Expect header.\n- [#1560](https://github.com/sanic-org/sanic/pull/1560) Allow to\n disable Transfer-Encoding: chunked.\n- [#1558](https://github.com/sanic-org/sanic/pull/1558) Fix graceful\n shutdown.\n- [#1594](https://github.com/sanic-org/sanic/pull/1594) Strict\n Slashes behavior fix\n\n**Deprecations and Removals**\n\n- [#1544](https://github.com/sanic-org/sanic/pull/1544) Drop\n dependency on distutil\n- [#1562](https://github.com/sanic-org/sanic/pull/1562) Drop support\n for Python 3.5\n- [#1568](https://github.com/sanic-org/sanic/pull/1568) Deprecate\n route removal.\n\n.. warning:: Warning\n\n Sanic will not support Python 3.5 from version 19.6 and forward. \n However, version 18.12LTS will have its support period extended thru\n December 2020, and therefore passing Python\\'s official support version\n 3.5, which is set to expire in September 2020.\n\n## Version 19.3\n\n**Features**\n\n- [#1497](https://github.com/sanic-org/sanic/pull/1497) Add support\n for zero-length and RFC 5987 encoded filename for\n multipart/form-data requests.\n\n- [#1484](https://github.com/sanic-org/sanic/pull/1484) The type of\n `expires` attribute of `sanic.cookies.Cookie` is now enforced to\n be of type `datetime`.\n\n- [#1482](https://github.com/sanic-org/sanic/pull/1482) Add support\n for the `stream` parameter of `sanic.Sanic.add_route()` available\n to `sanic.Blueprint.add_route()`.\n\n- [#1481](https://github.com/sanic-org/sanic/pull/1481) Accept\n negative values for route parameters with type `int` or `number`.\n\n- [#1476](https://github.com/sanic-org/sanic/pull/1476) Deprecated\n the use of `sanic.request.Request.raw_args` - it has a fundamental\n flaw in which is drops repeated query string parameters. Added\n `sanic.request.Request.query_args` as a replacement for the\n original use-case.\n\n- [#1472](https://github.com/sanic-org/sanic/pull/1472) Remove an\n unwanted `None` check in Request class `repr` implementation. This\n changes the default `repr` of a Request from `` to\n ``\n\n- [#1470](https://github.com/sanic-org/sanic/pull/1470) Added 2 new\n parameters to `sanic.app.Sanic.create_server`:\n\n - `return_asyncio_server` - whether to return an\n asyncio.Server.\n - `asyncio_server_kwargs` - kwargs to pass to\n `loop.create_server` for the event loop that sanic is using.\n >\n This is a breaking change.\n\n- [#1499](https://github.com/sanic-org/sanic/pull/1499) Added a set\n of test cases that test and benchmark route resolution.\n\n- [#1457](https://github.com/sanic-org/sanic/pull/1457) The type of\n the `\"max-age\"` value in a `sanic.cookies.Cookie` is now enforced\n to be an integer. Non-integer values are replaced with `0`.\n\n- [#1445](https://github.com/sanic-org/sanic/pull/1445) Added the\n `endpoint` attribute to an incoming `request`, containing the name\n of the handler function.\n\n- [#1423](https://github.com/sanic-org/sanic/pull/1423) Improved\n request streaming. `request.stream` is now a bounded-size buffer\n instead of an unbounded queue. Callers must now call\n `await request.stream.read()` instead of\n `await request.stream.get()` to read each portion of the body.\n\n This is a breaking change.\n\n**Bugfixes**\n\n- [#1502](https://github.com/sanic-org/sanic/pull/1502) Sanic was\n prefetching `time.time()` and updating it once per second to avoid\n excessive `time.time()` calls. The implementation was observed to\n cause memory leaks in some cases. The benefit of the prefetch\n appeared to negligible, so this has been removed. Fixes\n [#1500](https://github.com/sanic-org/sanic/pull/1500)\n- [#1501](https://github.com/sanic-org/sanic/pull/1501) Fix a bug in\n the auto-reloader when the process was launched as a module i.e.\n `python -m init0.mod1` where the sanic server is started in\n `init0/mod1.py` with `debug` enabled and imports another module in\n `init0`.\n- [#1376](https://github.com/sanic-org/sanic/pull/1376) Allow sanic\n test client to bind to a random port by specifying `port=None`\n when constructing a `SanicTestClient`\n- [#1399](https://github.com/sanic-org/sanic/pull/1399) Added the\n ability to specify middleware on a blueprint group, so that all\n routes produced from the blueprints in the group have the\n middleware applied.\n- [#1442](https://github.com/sanic-org/sanic/pull/1442) Allow the\n the use the `SANIC_ACCESS_LOG` environment variable to\n enable/disable the access log when not explicitly passed to\n `app.run()`. This allows the access log to be disabled for example\n when running via gunicorn.\n\n**Developer infrastructure**\n\n- [#1529](https://github.com/sanic-org/sanic/pull/1529) Update\n project PyPI credentials\n- [#1515](https://github.com/sanic-org/sanic/pull/1515) fix linter\n issue causing travis build failures (fix #1514)\n- [#1490](https://github.com/sanic-org/sanic/pull/1490) Fix python\n version in doc build\n- [#1478](https://github.com/sanic-org/sanic/pull/1478) Upgrade\n setuptools version and use native docutils in doc build\n- [#1464](https://github.com/sanic-org/sanic/pull/1464) Upgrade\n pytest, and fix caplog unit tests\n\n**Improved Documentation**\n\n- [#1516](https://github.com/sanic-org/sanic/pull/1516) Fix typo at\n the exception documentation\n- [#1510](https://github.com/sanic-org/sanic/pull/1510) fix typo in\n Asyncio example\n- [#1486](https://github.com/sanic-org/sanic/pull/1486)\n Documentation typo\n- [#1477](https://github.com/sanic-org/sanic/pull/1477) Fix grammar\n in README.md\n- [#1489](https://github.com/sanic-org/sanic/pull/1489) Added\n \\\"databases\\\" to the extensions list\n- [#1483](https://github.com/sanic-org/sanic/pull/1483) Add\n sanic-zipkin to extensions list\n- [#1487](https://github.com/sanic-org/sanic/pull/1487) Removed link\n to deleted repo, Sanic-OAuth, from the extensions list\n- [#1460](https://github.com/sanic-org/sanic/pull/1460) 18.12\n changelog\n- [#1449](https://github.com/sanic-org/sanic/pull/1449) Add example\n of amending request object\n- [#1446](https://github.com/sanic-org/sanic/pull/1446) Update\n README\n- [#1444](https://github.com/sanic-org/sanic/pull/1444) Update\n README\n- [#1443](https://github.com/sanic-org/sanic/pull/1443) Update\n README, including new logo\n- [#1440](https://github.com/sanic-org/sanic/pull/1440) fix minor\n type and pip install instruction mismatch\n- [#1424](https://github.com/sanic-org/sanic/pull/1424)\n Documentation Enhancements\n\nNote: 19.3.0 was skipped for packagement purposes and not released on\nPyPI\n\n## Version 18.12\n\n### 18.12.0\n\n- Changes:\n\n - Improved codebase test coverage from 81% to 91%.\n - Added stream_large_files and host examples in static_file\n document\n - Added methods to append and finish body content on Request\n (#1379)\n - Integrated with .appveyor.yml for windows ci support\n - Added documentation for AF_INET6 and AF_UNIX socket usage\n - Adopt black/isort for codestyle\n - Cancel task when connection_lost\n - Simplify request ip and port retrieval logic\n - Handle config error in load config file.\n - Integrate with codecov for CI\n - Add missed documentation for config section.\n - Deprecate Handler.log\n - Pinned httptools requirement to version 0.0.10+\n\n- Fixes:\n\n - Fix `remove_entity_headers` helper function (#1415)\n - Fix TypeError when use Blueprint.group() to group blueprint\n with default url_prefix, Use os.path.normpath to avoid invalid\n url_prefix like api//v1 f8a6af1 Rename the `http` module to\n `helpers` to prevent conflicts with the built-in Python http\n library (fixes #1323)\n - Fix unittests on windows\n - Fix Namespacing of sanic logger\n - Fix missing quotes in decorator example\n - Fix redirect with quoted param\n - Fix doc for latest blueprint code\n - Fix build of latex documentation relating to markdown lists\n - Fix loop exception handling in app.py\n - Fix content length mismatch in windows and other platform\n - Fix Range header handling for static files (#1402)\n - Fix the logger and make it work (#1397)\n - Fix type pikcle-\\>pickle in multiprocessing test\n - Fix pickling blueprints Change the string passed in the\n \\\"name\\\" section of the namedtuples in Blueprint to match the\n name of the Blueprint module attribute name. This allows\n blueprints to be pickled and unpickled, without errors, which\n is a requirement of running Sanic in multiprocessing mode in\n Windows. Added a test for pickling and unpickling blueprints\n Added a test for pickling and unpickling sanic itself Added a\n test for enabling multiprocessing on an app with a blueprint\n (only useful to catch this bug if the tests are run on\n Windows).\n - Fix document for logging\n\n## Version 0.8\n\n**0.8.3**\n\n- Changes:\n - Ownership changed to org \\'sanic-org\\'\n\n**0.8.0**\n\n- Changes:\n - Add Server-Sent Events extension (Innokenty Lebedev)\n - Graceful handling of request_handler_task cancellation (Ashley\n Sommer)\n - Sanitize URL before redirection (aveao)\n - Add url_bytes to request (johndoe46)\n - py37 support for travisci (yunstanford)\n - Auto reloader support for OSX (garyo)\n - Add UUID route support (Volodymyr Maksymiv)\n - Add pausable response streams (Ashley Sommer)\n - Add weakref to request slots (vopankov)\n - remove ubuntu 12.04 from test fixture due to deprecation\n (yunstanford)\n - Allow streaming handlers in add_route (kinware)\n - use travis_retry for tox (Raphael Deem)\n - update aiohttp version for test client (yunstanford)\n - add redirect import for clarity (yingshaoxo)\n - Update HTTP Entity headers (Arnulfo Solís)\n - Add register_listener method (Stephan Fitzpatrick)\n - Remove uvloop/ujson dependencies for Windows (abuckenheimer)\n - Content-length header on 204/304 responses (Arnulfo Solís)\n - Extend WebSocketProtocol arguments and add docs (Bob Olde\n Hampsink, yunstanford)\n - Update development status from pre-alpha to beta (Maksim\n Anisenkov)\n - KeepAlive Timeout log level changed to debug (Arnulfo Solís)\n - Pin pytest to 3.3.2 because of pytest-dev/pytest#3170 (Maksim\n Aniskenov)\n - Install Python 3.5 and 3.6 on docker container for tests (Shahin\n Azad)\n - Add support for blueprint groups and nesting (Elias Tarhini)\n - Remove uvloop for windows setup (Aleksandr Kurlov)\n - Auto Reload (Yaser Amari)\n - Documentation updates/fixups (multiple contributors)\n- Fixes:\n - Fix: auto_reload in Linux (Ashley Sommer)\n - Fix: broken tests for aiohttp \\>= 3.3.0 (Ashley Sommer)\n - Fix: disable auto_reload by default on windows (abuckenheimer)\n - Fix (1143): Turn off access log with gunicorn (hqy)\n - Fix (1268): Support status code for file response (Cosmo Borsky)\n - Fix (1266): Add content_type flag to Sanic.static (Cosmo Borsky)\n - Fix: subprotocols parameter missing from add_websocket_route\n (ciscorn)\n - Fix (1242): Responses for CI header (yunstanford)\n - Fix (1237): add version constraint for websockets (yunstanford)\n - Fix (1231): memory leak - always release resource (Phillip Xu)\n - Fix (1221): make request truthy if transport exists (Raphael\n Deem)\n - Fix failing tests for aiohttp\\>=3.1.0 (Ashley Sommer)\n - Fix try_everything examples (PyManiacGR, kot83)\n - Fix (1158): default to auto_reload in debug mode (Raphael Deem)\n - Fix (1136): ErrorHandler.response handler call too restrictive\n (Julien Castiaux)\n - Fix: raw requires bytes-like object (cloudship)\n - Fix (1120): passing a list in to a route decorator\\'s host arg\n (Timothy Ebiuwhe)\n - Fix: Bug in multipart/form-data parser (DirkGuijt)\n - Fix: Exception for missing parameter when value is null\n (NyanKiyoshi)\n - Fix: Parameter check (Howie Hu)\n - Fix (1089): Routing issue with named parameters and different\n methods (yunstanford)\n - Fix (1085): Signal handling in multi-worker mode (yunstanford)\n - Fix: single quote in readme.rst (Cosven)\n - Fix: method typos (Dmitry Dygalo)\n - Fix: log_response correct output for ip and port (Wibowo\n Arindrarto)\n - Fix (1042): Exception Handling (Raphael Deem)\n - Fix: Chinese URIs (Howie Hu)\n - Fix (1079): timeout bug when self.transport is None (Raphael\n Deem)\n - Fix (1074): fix strict_slashes when route has slash (Raphael\n Deem)\n - Fix (1050): add samesite cookie to cookie keys (Raphael Deem)\n - Fix (1065): allow add_task after server starts (Raphael Deem)\n - Fix (1061): double quotes in unauthorized exception (Raphael\n Deem)\n - Fix (1062): inject the app in add_task method (Raphael Deem)\n - Fix: update environment.yml for readthedocs (Eli Uriegas)\n - Fix: Cancel request task when response timeout is triggered\n (Jeong YunWon)\n - Fix (1052): Method not allowed response for RFC7231 compliance\n (Raphael Deem)\n - Fix: IPv6 Address and Socket Data Format (Dan Palmer)\n\nNote: Changelog was unmaintained between 0.1 and 0.7\n\n## Version 0.1\n\n**0.1.7**\n\n- Reversed static url and directory arguments to meet spec\n\n**0.1.6**\n\n- Static files\n- Lazy Cookie Loading\n\n**0.1.5**\n\n- Cookies\n- Blueprint listeners and ordering\n- Faster Router\n- Fix: Incomplete file reads on medium+ sized post requests\n- Breaking: after_start and before_stop now pass sanic as their\n first argument\n\n**0.1.4**\n\n- Multiprocessing\n\n**0.1.3**\n\n- Blueprint support\n- Faster Response processing\n\n**0.1.1 - 0.1.2**\n\n- Struggling to update pypi via CI\n\n**0.1.0**\n\n- Released to public\n" }, { "path": "guide/public/assets/.gitkeep", "content": "" }, { "path": "guide/public/assets/code.css", "content": "pre { line-height: 125%; }\ntd.linenos .normal { color: inherit; background-color: transparent; padding-left: 5px; padding-right: 5px; }\nspan.linenos { color: inherit; background-color: transparent; padding-left: 5px; padding-right: 5px; }\ntd.linenos .special { color: #000000; background-color: #ffffc0; padding-left: 5px; padding-right: 5px; }\nspan.linenos.special { color: #000000; background-color: #ffffc0; padding-left: 5px; padding-right: 5px; }\n.hll { background-color: #ffffcc }\n.c { color: #A2A2A2; font-style: italic } /* Comment */\n.err { color: #777 } /* Error */\n.esc { color: #777 } /* Escape */\n.g { color: #777 } /* Generic */\n.k { color: #FF0D68 } /* Keyword */\n.l { color: #777 } /* Literal */\n.n { color: #333 } /* Name */\n.o { color: #777 } /* Operator */\n.x { color: #777 } /* Other */\n.p { color: #777 } /* Punctuation */\n.ch { color: #A2A2A2; font-style: italic } /* Comment.Hashbang */\n.cm { color: #A2A2A2; font-style: italic } /* Comment.Multiline */\n.cp { color: #A2A2A2; font-style: italic } /* Comment.Preproc */\n.cpf { color: #A2A2A2; font-style: italic } /* Comment.PreprocFile */\n.c1 { color: #A2A2A2; font-style: italic } /* Comment.Single */\n.cs { color: #A2A2A2; font-style: italic } /* Comment.Special */\n.gd { color: #777 } /* Generic.Deleted */\n.ge { color: #777 } /* Generic.Emph */\n.ges { color: #777 } /* Generic.EmphStrong */\n.gr { color: #777 } /* Generic.Error */\n.gh { color: #777 } /* Generic.Heading */\n.gi { color: #777 } /* Generic.Inserted */\n.go { color: #777 } /* Generic.Output */\n.gp { color: #777 } /* Generic.Prompt */\n.gs { color: #777 } /* Generic.Strong */\n.gu { color: #777 } /* Generic.Subheading */\n.gt { color: #777 } /* Generic.Traceback */\n.kc { color: #FF0D68 } /* Keyword.Constant */\n.kd { color: #FF0D68 } /* Keyword.Declaration */\n.kn { color: #FF0D68 } /* Keyword.Namespace */\n.kp { color: #FF0D68 } /* Keyword.Pseudo */\n.kr { color: #FF0D68 } /* Keyword.Reserved */\n.kt { color: #FF0D68 } /* Keyword.Type */\n.ld { color: #777 } /* Literal.Date */\n.m { color: #777 } /* Literal.Number */\n.s { color: #833FE3; background-color: #EEE } /* Literal.String */\n.na { color: #333 } /* Name.Attribute */\n.nb { color: #333 } /* Name.Builtin */\n.nc { color: #37AE6F; font-weight: bold } /* Name.Class */\n.no { color: #333 } /* Name.Constant */\n.nd { color: #333 } /* Name.Decorator */\n.ni { color: #333 } /* Name.Entity */\n.ne { color: #333 } /* Name.Exception */\n.nf { color: #0092FF } /* Name.Function */\n.nl { color: #333 } /* Name.Label */\n.nn { color: #333 } /* Name.Namespace */\n.nx { color: #333 } /* Name.Other */\n.py { color: #333 } /* Name.Property */\n.nt { color: #333 } /* Name.Tag */\n.nv { color: #333 } /* Name.Variable */\n.ow { color: #777 } /* Operator.Word */\n.pm { color: #777 } /* Punctuation.Marker */\n.w { color: #777 } /* Text.Whitespace */\n.mb { color: #777 } /* Literal.Number.Bin */\n.mf { color: #777 } /* Literal.Number.Float */\n.mh { color: #777 } /* Literal.Number.Hex */\n.mi { color: #777 } /* Literal.Number.Integer */\n.mo { color: #777 } /* Literal.Number.Oct */\n.sa { color: #833FE3; background-color: #EEE } /* Literal.String.Affix */\n.sb { color: #833FE3; background-color: #EEE } /* Literal.String.Backtick */\n.sc { color: #833FE3; background-color: #EEE } /* Literal.String.Char */\n.dl { color: #833FE3; background-color: #EEE } /* Literal.String.Delimiter */\n.sd { color: #833FE3; background-color: #EEE } /* Literal.String.Doc */\n.s2 { color: #833FE3; background-color: #EEE } /* Literal.String.Double */\n.se { color: #833FE3; background-color: #EEE } /* Literal.String.Escape */\n.sh { color: #833FE3; background-color: #EEE } /* Literal.String.Heredoc */\n.si { color: #833FE3; background-color: #EEE } /* Literal.String.Interpol */\n.sx { color: #833FE3; background-color: #EEE } /* Literal.String.Other */\n.sr { color: #833FE3; background-color: #EEE } /* Literal.String.Regex */\n.s1 { color: #833FE3; background-color: #EEE } /* Literal.String.Single */\n.ss { color: #833FE3; background-color: #EEE } /* Literal.String.Symbol */\n.bp { color: #333 } /* Name.Builtin.Pseudo */\n.fm { color: #0092FF } /* Name.Function.Magic */\n.vc { color: #333 } /* Name.Variable.Class */\n.vg { color: #333 } /* Name.Variable.Global */\n.vi { color: #333 } /* Name.Variable.Instance */\n.vm { color: #333 } /* Name.Variable.Magic */\n.il { color: #777 } /* Literal.Number.Integer.Long */" }, { "path": "guide/public/assets/docs.js", "content": "let burger;\nlet menu;\nlet menuLinks;\nlet menuGroups;\nlet anchors;\nlet lastUpdated = 0;\nlet updateFrequency = 300;\nfunction trigger(el, eventType) {\n if (typeof eventType === \"string\" && typeof el[eventType] === \"function\") {\n el[eventType]();\n } else {\n const event =\n typeof eventType === \"string\"\n ? new Event(eventType, { bubbles: true })\n : eventType;\n el.dispatchEvent(event);\n }\n}\nfunction refreshBurger() {\n burger = document.querySelector(\".burger\");\n}\nfunction refreshMenu() {\n menu = document.querySelector(\".menu\");\n}\nfunction refreshMenuLinks() {\n menuLinks = document.querySelectorAll(\".menu a[hx-get]\");\n}\nfunction refreshMenuGroups() {\n menuGroups = document.querySelectorAll(\".menu li.is-group a:not([href])\");\n}\nfunction hasActiveLink(element) {\n if (!element) {\n return false;\n }\n let nextElementSibling = element.nextElementSibling;\n let menuList = null;\n while (!menuList && nextElementSibling) {\n if (nextElementSibling.classList.contains(\"menu-list\")) {\n menuList = nextElementSibling;\n } else {\n nextElementSibling = nextElementSibling.nextElementSibling;\n }\n }\n if (menuList) {\n const siblinkLinks = [...menuList.querySelectorAll(\"a\")];\n return siblinkLinks.some((el) => el.classList.contains(\"is-active\"));\n }\n return false;\n}\nfunction scrollHandler(e) {\n let now = Date.now();\n if (now - lastUpdated < updateFrequency) return;\n \n let closestAnchor = null;\n let closestDistance = Infinity;\n\n if (!anchors) { return; }\n\n anchors.forEach(anchor => {\n const rect = anchor.getBoundingClientRect();\n const distance = Math.abs(rect.top);\n\n if (distance < closestDistance) {\n closestDistance = distance;\n closestAnchor = anchor;\n }\n });\n\n if (closestAnchor) {\n history.replaceState(null, null, \"#\" + closestAnchor.id);\n\tlastUpdated = now;\n }\n}\nfunction initBurger() {\n if (!burger || !menu) {\n return;\n }\n burger.addEventListener(\"click\", (e) => {\n e.preventDefault();\n burger.classList.toggle(\"is-active\");\n menu.classList.toggle(\"is-active\");\n });\n}\nfunction initMenuGroups() {\n menuGroups.forEach((el) => {\n el.addEventListener(\"click\", (e) => {\n e.preventDefault();\n menuGroups.forEach((g) => {\n if (g === el) {\n g.classList.toggle(\"is-open\");\n } else {\n g.classList.remove(\"is-open\");\n }\n });\n });\n });\n}\nfunction initDetails() {\n const detailsElements = document.querySelectorAll(\".details\");\n detailsElements.forEach((element) => {\n element.addEventListener(\"click\", function () {\n this.classList.toggle(\"is-active\");\n });\n });\n}\nfunction initTabs() {\n const tabsElements = document.querySelectorAll(\".tabs\");\n\n tabsElements.forEach((element) => {\n const tabTriggers = element.querySelectorAll(\"li>a\");\n const tabs = element.querySelectorAll(\"li\");\n tabTriggers.forEach((trigger) => {\n trigger.addEventListener(\"click\", function () {\n tabs.forEach((tab) => {\n tab.classList.remove(\"is-active\");\n });\n const content = this.nextElementSibling;\n // this.parentElement.querySelector(\".tab-content\");\n this.parentElement.classList.add(\"is-active\");\n const tabDisplay =\n this.parentElement.parentElement.parentElement\n .nextElementSibling;\n tabDisplay.innerHTML = content.innerHTML;\n });\n });\n const firstTabTrigger = tabTriggers[0];\n firstTabTrigger.click();\n });\n}\nfunction initSearch() {\n const searchInput = document.querySelector(\"#search\");\n if (!searchInput) { return; }\n searchInput.addEventListener(\"keyup\", () => {\n const value = searchInput.value;\n searchInput.setAttribute(\n \"hx-vals\",\n `{\"q\": \"${encodeURIComponent(value)}\"}`\n );\n });\n}\nfunction initMermaid() {\n const mermaids = document.querySelectorAll(\".mermaid\");\n mermaid.init(undefined, mermaids);\n}\nfunction refreshAnchors() {\n anchors = document.querySelectorAll(\"h1[id], h2[id], h3[id], h4[id], h5[id], h6[id]\");\n};\n\nfunction setMenuLinkActive(href) {\n burger.classList.remove(\"is-active\");\n menu.classList.remove(\"is-active\");\n menuLinks.forEach((element) => {\n if (element.attributes.href.value === href) {\n element.classList.add(\"is-active\");\n } else {\n element.classList.remove(\"is-active\");\n }\n });\n menuGroups.forEach((g) => {\n if (hasActiveLink(g)) {\n g.classList.add(\"is-open\");\n } else {\n g.classList.remove(\"is-open\");\n }\n });\n}\t\nfunction copyCode(button) {\n const codeBlock = button.parentElement;\n const code = codeBlock.querySelector(\"code\").innerText;\n const textarea = document.createElement(\"textarea\");\n textarea.value = code;\n document.body.appendChild(textarea);\n textarea.select();\n document.execCommand(\"copy\");\n document.body.removeChild(textarea);\n\n button.classList.add(\"clicked\"); // Add class for animation\n\n setTimeout(() => {\n button.classList.remove(\"clicked\"); // Remove class to revert to original state\n }, 1500);\n}\nfunction init() {\n refreshBurger();\n refreshMenu();\n refreshMenuLinks();\n refreshMenuGroups();\n refreshAnchors();\n initBurger();\n initMenuGroups();\n initDetails();\n initTabs();\n initSearch();\n}\n\nfunction afterSwap(e) {\n setMenuLinkActive(e.detail.pathInfo.requestPath);\n initMermaid();\n window.scrollTo(0, 0);\n const newTitle = event.detail.xhr.getResponseHeader('X-Title');\n if (newTitle) {\n\tdocument.title = newTitle;\n }\n}\nfunction beforeRequest() {\n console.log(\"beforeRequest\")\n document.querySelector(\".loading-bar\").classList.add(\"is-loading\");\n this.requestStartTime = new Date().getTime();\n}\nfunction afterRequest() {\n const currentTime = new Date().getTime();\n const elapsedTime = currentTime - this.requestStartTime;\n const delay = Math.max(0, 1000 - elapsedTime);\n setTimeout(() => {\n\tconsole.log(\"afterRequest\")\n\tdocument.querySelector(\".loading-bar\").classList.remove(\"is-loading\");\n }, delay);\n}\ndocument.addEventListener(\"DOMContentLoaded\", init);\ndocument.body.addEventListener(\"htmx:afterSwap\", afterSwap);\ndocument.addEventListener(\"scroll\", scrollHandler);\ndocument.body.addEventListener(\"htmx:beforeRequest\", beforeRequest);\ndocument.body.addEventListener(\"htmx:afterRequest\", afterRequest);\n" }, { "path": "guide/public/assets/style.css", "content": "@charset \"UTF-8\";\n.has-text-purple {\n color: #833FE3; }\n\n/*! bulma.io v0.9.4 | MIT License | github.com/jgthms/bulma */\n/* Bulma Utilities */\n.pagination-previous,\n.pagination-next,\n.pagination-link,\n.pagination-ellipsis, .file-cta,\n.file-name, .select select, .textarea, .input, .button {\n -moz-appearance: none;\n -webkit-appearance: none;\n align-items: center;\n border: 1px solid transparent;\n border-radius: 4px;\n box-shadow: none;\n display: inline-flex;\n font-size: 1rem;\n height: 2.5em;\n justify-content: flex-start;\n line-height: 1.5;\n padding-bottom: calc(0.5em - 1px);\n padding-left: calc(0.75em - 1px);\n padding-right: calc(0.75em - 1px);\n padding-top: calc(0.5em - 1px);\n position: relative;\n vertical-align: top; }\n .pagination-previous:focus,\n .pagination-next:focus,\n .pagination-link:focus,\n .pagination-ellipsis:focus, .file-cta:focus,\n .file-name:focus, .select select:focus, .textarea:focus, .input:focus, .button:focus, .is-focused.pagination-previous,\n .is-focused.pagination-next,\n .is-focused.pagination-link,\n .is-focused.pagination-ellipsis, .is-focused.file-cta,\n .is-focused.file-name, .select select.is-focused, .is-focused.textarea, .is-focused.input, .is-focused.button, .pagination-previous:active,\n .pagination-next:active,\n .pagination-link:active,\n .pagination-ellipsis:active, .file-cta:active,\n .file-name:active, .select select:active, .textarea:active, .input:active, .button:active, .is-active.pagination-previous,\n .is-active.pagination-next,\n .is-active.pagination-link,\n .is-active.pagination-ellipsis, .is-active.file-cta,\n .is-active.file-name, .select select.is-active, .is-active.textarea, .is-active.input, .is-active.button {\n outline: none; }\n [disabled].pagination-previous,\n [disabled].pagination-next,\n [disabled].pagination-link,\n [disabled].pagination-ellipsis, [disabled].file-cta,\n [disabled].file-name, .select select[disabled], [disabled].textarea, [disabled].input, [disabled].button, fieldset[disabled] .pagination-previous,\n fieldset[disabled] .pagination-next,\n fieldset[disabled] .pagination-link,\n fieldset[disabled] .pagination-ellipsis, fieldset[disabled] .file-cta,\n fieldset[disabled] .file-name, fieldset[disabled] .select select, .select fieldset[disabled] select, fieldset[disabled] .textarea, fieldset[disabled] .input, fieldset[disabled] .button {\n cursor: not-allowed; }\n\n.is-unselectable, .tabs, .pagination-previous,\n.pagination-next,\n.pagination-link,\n.pagination-ellipsis, .breadcrumb, .file, .button {\n -webkit-touch-callout: none;\n -webkit-user-select: none;\n -moz-user-select: none;\n -ms-user-select: none;\n user-select: none; }\n\n.navbar-link:not(.is-arrowless)::after, .select:not(.is-multiple):not(.is-loading)::after {\n border: 3px solid transparent;\n border-radius: 2px;\n border-right: 0;\n border-top: 0;\n content: \" \";\n display: block;\n height: 0.625em;\n margin-top: -0.4375em;\n pointer-events: none;\n position: absolute;\n top: 50%;\n transform: rotate(-45deg);\n transform-origin: center;\n width: 0.625em; }\n\n.tabs:not(:last-child), .pagination:not(:last-child), .message:not(:last-child), .level:not(:last-child), .breadcrumb:not(:last-child), .block:not(:last-child), .title:not(:last-child),\n.subtitle:not(:last-child), .table-container:not(:last-child), .table:not(:last-child), .progress:not(:last-child), .notification:not(:last-child), .content:not(:last-child), .box:not(:last-child) {\n margin-bottom: 1.5rem; }\n\n.modal-close, .delete {\n -webkit-touch-callout: none;\n -webkit-user-select: none;\n -moz-user-select: none;\n -ms-user-select: none;\n user-select: none;\n -moz-appearance: none;\n -webkit-appearance: none;\n background-color: rgba(10, 10, 10, 0.2);\n border: none;\n border-radius: 9999px;\n cursor: pointer;\n pointer-events: auto;\n display: inline-block;\n flex-grow: 0;\n flex-shrink: 0;\n font-size: 0;\n height: 20px;\n max-height: 20px;\n max-width: 20px;\n min-height: 20px;\n min-width: 20px;\n outline: none;\n position: relative;\n vertical-align: top;\n width: 20px; }\n .modal-close::before, .delete::before, .modal-close::after, .delete::after {\n background-color: white;\n content: \"\";\n display: block;\n left: 50%;\n position: absolute;\n top: 50%;\n transform: translateX(-50%) translateY(-50%) rotate(45deg);\n transform-origin: center center; }\n .modal-close::before, .delete::before {\n height: 2px;\n width: 50%; }\n .modal-close::after, .delete::after {\n height: 50%;\n width: 2px; }\n .modal-close:hover, .delete:hover, .modal-close:focus, .delete:focus {\n background-color: rgba(10, 10, 10, 0.3); }\n .modal-close:active, .delete:active {\n background-color: rgba(10, 10, 10, 0.4); }\n .is-small.modal-close, .is-small.delete {\n height: 16px;\n max-height: 16px;\n max-width: 16px;\n min-height: 16px;\n min-width: 16px;\n width: 16px; }\n .is-medium.modal-close, .is-medium.delete {\n height: 24px;\n max-height: 24px;\n max-width: 24px;\n min-height: 24px;\n min-width: 24px;\n width: 24px; }\n .is-large.modal-close, .is-large.delete {\n height: 32px;\n max-height: 32px;\n max-width: 32px;\n min-height: 32px;\n min-width: 32px;\n width: 32px; }\n\n.control.is-loading::after, .select.is-loading::after, .loader, .button.is-loading::after {\n animation: spinAround 500ms infinite linear;\n border: 2px solid #dbdbdb;\n border-radius: 9999px;\n border-right-color: transparent;\n border-top-color: transparent;\n content: \"\";\n display: block;\n height: 1em;\n position: relative;\n width: 1em; }\n\n.hero-video, .is-overlay, .modal-background, .modal, .image.is-square img,\n.image.is-square .has-ratio, .image.is-1by1 img,\n.image.is-1by1 .has-ratio, .image.is-5by4 img,\n.image.is-5by4 .has-ratio, .image.is-4by3 img,\n.image.is-4by3 .has-ratio, .image.is-3by2 img,\n.image.is-3by2 .has-ratio, .image.is-5by3 img,\n.image.is-5by3 .has-ratio, .image.is-16by9 img,\n.image.is-16by9 .has-ratio, .image.is-2by1 img,\n.image.is-2by1 .has-ratio, .image.is-3by1 img,\n.image.is-3by1 .has-ratio, .image.is-4by5 img,\n.image.is-4by5 .has-ratio, .image.is-3by4 img,\n.image.is-3by4 .has-ratio, .image.is-2by3 img,\n.image.is-2by3 .has-ratio, .image.is-3by5 img,\n.image.is-3by5 .has-ratio, .image.is-9by16 img,\n.image.is-9by16 .has-ratio, .image.is-1by2 img,\n.image.is-1by2 .has-ratio, .image.is-1by3 img,\n.image.is-1by3 .has-ratio {\n bottom: 0;\n left: 0;\n position: absolute;\n right: 0;\n top: 0; }\n\n.navbar-burger {\n -moz-appearance: none;\n -webkit-appearance: none;\n appearance: none;\n background: none;\n border: none;\n color: currentColor;\n font-family: inherit;\n font-size: 1em;\n margin: 0;\n padding: 0; }\n\n/* Bulma Base */\n/*! minireset.css v0.0.6 | MIT License | github.com/jgthms/minireset.css */\nhtml,\nbody,\np,\nol,\nul,\nli,\ndl,\ndt,\ndd,\nblockquote,\nfigure,\nfieldset,\nlegend,\ntextarea,\npre,\niframe,\nhr,\nh1,\nh2,\nh3,\nh4,\nh5,\nh6 {\n margin: 0;\n padding: 0; }\n\nh1,\nh2,\nh3,\nh4,\nh5,\nh6 {\n font-size: 100%;\n font-weight: normal; }\n\nul {\n list-style: none; }\n\nbutton,\ninput,\nselect,\ntextarea {\n margin: 0; }\n\nhtml {\n box-sizing: border-box; }\n\n*, *::before, *::after {\n box-sizing: inherit; }\n\nimg,\nvideo {\n height: auto;\n max-width: 100%; }\n\niframe {\n border: 0; }\n\ntable {\n border-collapse: collapse;\n border-spacing: 0; }\n\ntd,\nth {\n padding: 0; }\n td:not([align]),\n th:not([align]) {\n text-align: inherit; }\n\nhtml {\n background-color: white;\n font-size: 20px;\n -moz-osx-font-smoothing: grayscale;\n -webkit-font-smoothing: antialiased;\n min-width: 300px;\n overflow-x: hidden;\n overflow-y: scroll;\n text-rendering: optimizeLegibility;\n text-size-adjust: 100%; }\n\narticle,\naside,\nfigure,\nfooter,\nheader,\nhgroup,\nsection {\n display: block; }\n\nbody,\nbutton,\ninput,\noptgroup,\nselect,\ntextarea {\n font-family: BlinkMacSystemFont, -apple-system, \"Segoe UI\", \"Roboto\", \"Oxygen\", \"Ubuntu\", \"Cantarell\", \"Fira Sans\", \"Droid Sans\", \"Helvetica Neue\", \"Helvetica\", \"Arial\", sans-serif; }\n\ncode,\npre {\n -moz-osx-font-smoothing: auto;\n -webkit-font-smoothing: auto;\n font-family: monospace; }\n\nbody {\n color: #4a4a4a;\n font-size: 1em;\n font-weight: 400;\n line-height: 1.5; }\n\na {\n color: #ff0d68;\n cursor: pointer;\n text-decoration: none; }\n a strong {\n color: currentColor; }\n a:hover {\n color: #363636; }\n\ncode {\n background-color: whitesmoke;\n color: #da1039;\n font-size: 0.875em;\n font-weight: normal;\n padding: 0.25em 0.5em 0.25em; }\n\nhr {\n background-color: whitesmoke;\n border: none;\n display: block;\n height: 2px;\n margin: 1.5rem 0; }\n\nimg {\n height: auto;\n max-width: 100%; }\n\ninput[type=\"checkbox\"],\ninput[type=\"radio\"] {\n vertical-align: baseline; }\n\nsmall {\n font-size: 0.875em; }\n\nspan {\n font-style: inherit;\n font-weight: inherit; }\n\nstrong {\n color: #363636;\n font-weight: 700; }\n\nfieldset {\n border: none; }\n\npre {\n -webkit-overflow-scrolling: touch;\n background-color: whitesmoke;\n color: #4a4a4a;\n font-size: 0.875em;\n overflow-x: auto;\n padding: 1.25rem 1.5rem;\n white-space: pre;\n word-wrap: normal; }\n pre code {\n background-color: transparent;\n color: currentColor;\n font-size: 1em;\n padding: 0; }\n\ntable td,\ntable th {\n vertical-align: top; }\n table td:not([align]),\n table th:not([align]) {\n text-align: inherit; }\n\ntable th {\n color: #363636; }\n\n@keyframes spinAround {\n from {\n transform: rotate(0deg); }\n to {\n transform: rotate(359deg); } }\n\n/* Bulma Elements */\n.box {\n background-color: white;\n border-radius: 6px;\n box-shadow: 0 0.5em 1em -0.125em rgba(10, 10, 10, 0.1), 0 0px 0 1px rgba(10, 10, 10, 0.02);\n color: #4a4a4a;\n display: block;\n padding: 1.25rem; }\n\na.box:hover, a.box:focus {\n box-shadow: 0 0.5em 1em -0.125em rgba(10, 10, 10, 0.1), 0 0 0 1px #ff0d68; }\n\na.box:active {\n box-shadow: inset 0 1px 2px rgba(10, 10, 10, 0.2), 0 0 0 1px #ff0d68; }\n\n.button {\n background-color: white;\n border-color: #dbdbdb;\n border-width: 1px;\n color: #363636;\n cursor: pointer;\n justify-content: center;\n padding-bottom: calc(0.5em - 1px);\n padding-left: 1em;\n padding-right: 1em;\n padding-top: calc(0.5em - 1px);\n text-align: center;\n white-space: nowrap; }\n .button strong {\n color: inherit; }\n .button .icon, .button .icon.is-small, .button .icon.is-medium, .button .icon.is-large {\n height: 1.5em;\n width: 1.5em; }\n .button .icon:first-child:not(:last-child) {\n margin-left: calc(-0.5em - 1px);\n margin-right: 0.25em; }\n .button .icon:last-child:not(:first-child) {\n margin-left: 0.25em;\n margin-right: calc(-0.5em - 1px); }\n .button .icon:first-child:last-child {\n margin-left: calc(-0.5em - 1px);\n margin-right: calc(-0.5em - 1px); }\n .button:hover, .button.is-hovered {\n border-color: #b5b5b5;\n color: #363636; }\n .button:focus, .button.is-focused {\n border-color: #0092FF;\n color: #363636; }\n .button:focus:not(:active), .button.is-focused:not(:active) {\n box-shadow: 0 0 0 0.125em rgba(255, 13, 104, 0.25); }\n .button:active, .button.is-active {\n border-color: #4a4a4a;\n color: #363636; }\n .button.is-text {\n background-color: transparent;\n border-color: transparent;\n color: #4a4a4a;\n text-decoration: underline; }\n .button.is-text:hover, .button.is-text.is-hovered, .button.is-text:focus, .button.is-text.is-focused {\n background-color: whitesmoke;\n color: #363636; }\n .button.is-text:active, .button.is-text.is-active {\n background-color: #e8e8e8;\n color: #363636; }\n .button.is-text[disabled], fieldset[disabled] .button.is-text {\n background-color: transparent;\n border-color: transparent;\n box-shadow: none; }\n .button.is-ghost {\n background: none;\n border-color: transparent;\n color: #ff0d68;\n text-decoration: none; }\n .button.is-ghost:hover, .button.is-ghost.is-hovered {\n color: #ff0d68;\n text-decoration: underline; }\n .button.is-white {\n background-color: white;\n border-color: transparent;\n color: #0a0a0a; }\n .button.is-white:hover, .button.is-white.is-hovered {\n background-color: #f9f9f9;\n border-color: transparent;\n color: #0a0a0a; }\n .button.is-white:focus, .button.is-white.is-focused {\n border-color: transparent;\n color: #0a0a0a; }\n .button.is-white:focus:not(:active), .button.is-white.is-focused:not(:active) {\n box-shadow: 0 0 0 0.125em rgba(255, 255, 255, 0.25); }\n .button.is-white:active, .button.is-white.is-active {\n background-color: #f2f2f2;\n border-color: transparent;\n color: #0a0a0a; }\n .button.is-white[disabled], fieldset[disabled] .button.is-white {\n background-color: white;\n border-color: white;\n box-shadow: none; }\n .button.is-white.is-inverted {\n background-color: #0a0a0a;\n color: white; }\n .button.is-white.is-inverted:hover, .button.is-white.is-inverted.is-hovered {\n background-color: black; }\n .button.is-white.is-inverted[disabled], fieldset[disabled] .button.is-white.is-inverted {\n background-color: #0a0a0a;\n border-color: transparent;\n box-shadow: none;\n color: white; }\n .button.is-white.is-loading::after {\n border-color: transparent transparent #0a0a0a #0a0a0a !important; }\n .button.is-white.is-outlined {\n background-color: transparent;\n border-color: white;\n color: white; }\n .button.is-white.is-outlined:hover, .button.is-white.is-outlined.is-hovered, .button.is-white.is-outlined:focus, .button.is-white.is-outlined.is-focused {\n background-color: white;\n border-color: white;\n color: #0a0a0a; }\n .button.is-white.is-outlined.is-loading::after {\n border-color: transparent transparent white white !important; }\n .button.is-white.is-outlined.is-loading:hover::after, .button.is-white.is-outlined.is-loading.is-hovered::after, .button.is-white.is-outlined.is-loading:focus::after, .button.is-white.is-outlined.is-loading.is-focused::after {\n border-color: transparent transparent #0a0a0a #0a0a0a !important; }\n .button.is-white.is-outlined[disabled], fieldset[disabled] .button.is-white.is-outlined {\n background-color: transparent;\n border-color: white;\n box-shadow: none;\n color: white; }\n .button.is-white.is-inverted.is-outlined {\n background-color: transparent;\n border-color: #0a0a0a;\n color: #0a0a0a; }\n .button.is-white.is-inverted.is-outlined:hover, .button.is-white.is-inverted.is-outlined.is-hovered, .button.is-white.is-inverted.is-outlined:focus, .button.is-white.is-inverted.is-outlined.is-focused {\n background-color: #0a0a0a;\n color: white; }\n .button.is-white.is-inverted.is-outlined.is-loading:hover::after, .button.is-white.is-inverted.is-outlined.is-loading.is-hovered::after, .button.is-white.is-inverted.is-outlined.is-loading:focus::after, .button.is-white.is-inverted.is-outlined.is-loading.is-focused::after {\n border-color: transparent transparent white white !important; }\n .button.is-white.is-inverted.is-outlined[disabled], fieldset[disabled] .button.is-white.is-inverted.is-outlined {\n background-color: transparent;\n border-color: #0a0a0a;\n box-shadow: none;\n color: #0a0a0a; }\n .button.is-black {\n background-color: #0a0a0a;\n border-color: transparent;\n color: white; }\n .button.is-black:hover, .button.is-black.is-hovered {\n background-color: #040404;\n border-color: transparent;\n color: white; }\n .button.is-black:focus, .button.is-black.is-focused {\n border-color: transparent;\n color: white; }\n .button.is-black:focus:not(:active), .button.is-black.is-focused:not(:active) {\n box-shadow: 0 0 0 0.125em rgba(10, 10, 10, 0.25); }\n .button.is-black:active, .button.is-black.is-active {\n background-color: black;\n border-color: transparent;\n color: white; }\n .button.is-black[disabled], fieldset[disabled] .button.is-black {\n background-color: #0a0a0a;\n border-color: #0a0a0a;\n box-shadow: none; }\n .button.is-black.is-inverted {\n background-color: white;\n color: #0a0a0a; }\n .button.is-black.is-inverted:hover, .button.is-black.is-inverted.is-hovered {\n background-color: #f2f2f2; }\n .button.is-black.is-inverted[disabled], fieldset[disabled] .button.is-black.is-inverted {\n background-color: white;\n border-color: transparent;\n box-shadow: none;\n color: #0a0a0a; }\n .button.is-black.is-loading::after {\n border-color: transparent transparent white white !important; }\n .button.is-black.is-outlined {\n background-color: transparent;\n border-color: #0a0a0a;\n color: #0a0a0a; }\n .button.is-black.is-outlined:hover, .button.is-black.is-outlined.is-hovered, .button.is-black.is-outlined:focus, .button.is-black.is-outlined.is-focused {\n background-color: #0a0a0a;\n border-color: #0a0a0a;\n color: white; }\n .button.is-black.is-outlined.is-loading::after {\n border-color: transparent transparent #0a0a0a #0a0a0a !important; }\n .button.is-black.is-outlined.is-loading:hover::after, .button.is-black.is-outlined.is-loading.is-hovered::after, .button.is-black.is-outlined.is-loading:focus::after, .button.is-black.is-outlined.is-loading.is-focused::after {\n border-color: transparent transparent white white !important; }\n .button.is-black.is-outlined[disabled], fieldset[disabled] .button.is-black.is-outlined {\n background-color: transparent;\n border-color: #0a0a0a;\n box-shadow: none;\n color: #0a0a0a; }\n .button.is-black.is-inverted.is-outlined {\n background-color: transparent;\n border-color: white;\n color: white; }\n .button.is-black.is-inverted.is-outlined:hover, .button.is-black.is-inverted.is-outlined.is-hovered, .button.is-black.is-inverted.is-outlined:focus, .button.is-black.is-inverted.is-outlined.is-focused {\n background-color: white;\n color: #0a0a0a; }\n .button.is-black.is-inverted.is-outlined.is-loading:hover::after, .button.is-black.is-inverted.is-outlined.is-loading.is-hovered::after, .button.is-black.is-inverted.is-outlined.is-loading:focus::after, .button.is-black.is-inverted.is-outlined.is-loading.is-focused::after {\n border-color: transparent transparent #0a0a0a #0a0a0a !important; }\n .button.is-black.is-inverted.is-outlined[disabled], fieldset[disabled] .button.is-black.is-inverted.is-outlined {\n background-color: transparent;\n border-color: white;\n box-shadow: none;\n color: white; }\n .button.is-light {\n background-color: whitesmoke;\n border-color: transparent;\n color: rgba(0, 0, 0, 0.7); }\n .button.is-light:hover, .button.is-light.is-hovered {\n background-color: #eeeeee;\n border-color: transparent;\n color: rgba(0, 0, 0, 0.7); }\n .button.is-light:focus, .button.is-light.is-focused {\n border-color: transparent;\n color: rgba(0, 0, 0, 0.7); }\n .button.is-light:focus:not(:active), .button.is-light.is-focused:not(:active) {\n box-shadow: 0 0 0 0.125em rgba(245, 245, 245, 0.25); }\n .button.is-light:active, .button.is-light.is-active {\n background-color: #e8e8e8;\n border-color: transparent;\n color: rgba(0, 0, 0, 0.7); }\n .button.is-light[disabled], fieldset[disabled] .button.is-light {\n background-color: whitesmoke;\n border-color: whitesmoke;\n box-shadow: none; }\n .button.is-light.is-inverted {\n background-color: rgba(0, 0, 0, 0.7);\n color: whitesmoke; }\n .button.is-light.is-inverted:hover, .button.is-light.is-inverted.is-hovered {\n background-color: rgba(0, 0, 0, 0.7); }\n .button.is-light.is-inverted[disabled], fieldset[disabled] .button.is-light.is-inverted {\n background-color: rgba(0, 0, 0, 0.7);\n border-color: transparent;\n box-shadow: none;\n color: whitesmoke; }\n .button.is-light.is-loading::after {\n border-color: transparent transparent rgba(0, 0, 0, 0.7) rgba(0, 0, 0, 0.7) !important; }\n .button.is-light.is-outlined {\n background-color: transparent;\n border-color: whitesmoke;\n color: whitesmoke; }\n .button.is-light.is-outlined:hover, .button.is-light.is-outlined.is-hovered, .button.is-light.is-outlined:focus, .button.is-light.is-outlined.is-focused {\n background-color: whitesmoke;\n border-color: whitesmoke;\n color: rgba(0, 0, 0, 0.7); }\n .button.is-light.is-outlined.is-loading::after {\n border-color: transparent transparent whitesmoke whitesmoke !important; }\n .button.is-light.is-outlined.is-loading:hover::after, .button.is-light.is-outlined.is-loading.is-hovered::after, .button.is-light.is-outlined.is-loading:focus::after, .button.is-light.is-outlined.is-loading.is-focused::after {\n border-color: transparent transparent rgba(0, 0, 0, 0.7) rgba(0, 0, 0, 0.7) !important; }\n .button.is-light.is-outlined[disabled], fieldset[disabled] .button.is-light.is-outlined {\n background-color: transparent;\n border-color: whitesmoke;\n box-shadow: none;\n color: whitesmoke; }\n .button.is-light.is-inverted.is-outlined {\n background-color: transparent;\n border-color: rgba(0, 0, 0, 0.7);\n color: rgba(0, 0, 0, 0.7); }\n .button.is-light.is-inverted.is-outlined:hover, .button.is-light.is-inverted.is-outlined.is-hovered, .button.is-light.is-inverted.is-outlined:focus, .button.is-light.is-inverted.is-outlined.is-focused {\n background-color: rgba(0, 0, 0, 0.7);\n color: whitesmoke; }\n .button.is-light.is-inverted.is-outlined.is-loading:hover::after, .button.is-light.is-inverted.is-outlined.is-loading.is-hovered::after, .button.is-light.is-inverted.is-outlined.is-loading:focus::after, .button.is-light.is-inverted.is-outlined.is-loading.is-focused::after {\n border-color: transparent transparent whitesmoke whitesmoke !important; }\n .button.is-light.is-inverted.is-outlined[disabled], fieldset[disabled] .button.is-light.is-inverted.is-outlined {\n background-color: transparent;\n border-color: rgba(0, 0, 0, 0.7);\n box-shadow: none;\n color: rgba(0, 0, 0, 0.7); }\n .button.is-dark {\n background-color: #363636;\n border-color: transparent;\n color: #fff; }\n .button.is-dark:hover, .button.is-dark.is-hovered {\n background-color: #2f2f2f;\n border-color: transparent;\n color: #fff; }\n .button.is-dark:focus, .button.is-dark.is-focused {\n border-color: transparent;\n color: #fff; }\n .button.is-dark:focus:not(:active), .button.is-dark.is-focused:not(:active) {\n box-shadow: 0 0 0 0.125em rgba(54, 54, 54, 0.25); }\n .button.is-dark:active, .button.is-dark.is-active {\n background-color: #292929;\n border-color: transparent;\n color: #fff; }\n .button.is-dark[disabled], fieldset[disabled] .button.is-dark {\n background-color: #363636;\n border-color: #363636;\n box-shadow: none; }\n .button.is-dark.is-inverted {\n background-color: #fff;\n color: #363636; }\n .button.is-dark.is-inverted:hover, .button.is-dark.is-inverted.is-hovered {\n background-color: #f2f2f2; }\n .button.is-dark.is-inverted[disabled], fieldset[disabled] .button.is-dark.is-inverted {\n background-color: #fff;\n border-color: transparent;\n box-shadow: none;\n color: #363636; }\n .button.is-dark.is-loading::after {\n border-color: transparent transparent #fff #fff !important; }\n .button.is-dark.is-outlined {\n background-color: transparent;\n border-color: #363636;\n color: #363636; }\n .button.is-dark.is-outlined:hover, .button.is-dark.is-outlined.is-hovered, .button.is-dark.is-outlined:focus, .button.is-dark.is-outlined.is-focused {\n background-color: #363636;\n border-color: #363636;\n color: #fff; }\n .button.is-dark.is-outlined.is-loading::after {\n border-color: transparent transparent #363636 #363636 !important; }\n .button.is-dark.is-outlined.is-loading:hover::after, .button.is-dark.is-outlined.is-loading.is-hovered::after, .button.is-dark.is-outlined.is-loading:focus::after, .button.is-dark.is-outlined.is-loading.is-focused::after {\n border-color: transparent transparent #fff #fff !important; }\n .button.is-dark.is-outlined[disabled], fieldset[disabled] .button.is-dark.is-outlined {\n background-color: transparent;\n border-color: #363636;\n box-shadow: none;\n color: #363636; }\n .button.is-dark.is-inverted.is-outlined {\n background-color: transparent;\n border-color: #fff;\n color: #fff; }\n .button.is-dark.is-inverted.is-outlined:hover, .button.is-dark.is-inverted.is-outlined.is-hovered, .button.is-dark.is-inverted.is-outlined:focus, .button.is-dark.is-inverted.is-outlined.is-focused {\n background-color: #fff;\n color: #363636; }\n .button.is-dark.is-inverted.is-outlined.is-loading:hover::after, .button.is-dark.is-inverted.is-outlined.is-loading.is-hovered::after, .button.is-dark.is-inverted.is-outlined.is-loading:focus::after, .button.is-dark.is-inverted.is-outlined.is-loading.is-focused::after {\n border-color: transparent transparent #363636 #363636 !important; }\n .button.is-dark.is-inverted.is-outlined[disabled], fieldset[disabled] .button.is-dark.is-inverted.is-outlined {\n background-color: transparent;\n border-color: #fff;\n box-shadow: none;\n color: #fff; }\n .button.is-primary {\n background-color: #ff0d68;\n border-color: transparent;\n color: #fff; }\n .button.is-primary:hover, .button.is-primary.is-hovered {\n background-color: #ff0060;\n border-color: transparent;\n color: #fff; }\n .button.is-primary:focus, .button.is-primary.is-focused {\n border-color: transparent;\n color: #fff; }\n .button.is-primary:focus:not(:active), .button.is-primary.is-focused:not(:active) {\n box-shadow: 0 0 0 0.125em rgba(255, 13, 104, 0.25); }\n .button.is-primary:active, .button.is-primary.is-active {\n background-color: #f3005b;\n border-color: transparent;\n color: #fff; }\n .button.is-primary[disabled], fieldset[disabled] .button.is-primary {\n background-color: #ff0d68;\n border-color: #ff0d68;\n box-shadow: none; }\n .button.is-primary.is-inverted {\n background-color: #fff;\n color: #ff0d68; }\n .button.is-primary.is-inverted:hover, .button.is-primary.is-inverted.is-hovered {\n background-color: #f2f2f2; }\n .button.is-primary.is-inverted[disabled], fieldset[disabled] .button.is-primary.is-inverted {\n background-color: #fff;\n border-color: transparent;\n box-shadow: none;\n color: #ff0d68; }\n .button.is-primary.is-loading::after {\n border-color: transparent transparent #fff #fff !important; }\n .button.is-primary.is-outlined {\n background-color: transparent;\n border-color: #ff0d68;\n color: #ff0d68; }\n .button.is-primary.is-outlined:hover, .button.is-primary.is-outlined.is-hovered, .button.is-primary.is-outlined:focus, .button.is-primary.is-outlined.is-focused {\n background-color: #ff0d68;\n border-color: #ff0d68;\n color: #fff; }\n .button.is-primary.is-outlined.is-loading::after {\n border-color: transparent transparent #ff0d68 #ff0d68 !important; }\n .button.is-primary.is-outlined.is-loading:hover::after, .button.is-primary.is-outlined.is-loading.is-hovered::after, .button.is-primary.is-outlined.is-loading:focus::after, .button.is-primary.is-outlined.is-loading.is-focused::after {\n border-color: transparent transparent #fff #fff !important; }\n .button.is-primary.is-outlined[disabled], fieldset[disabled] .button.is-primary.is-outlined {\n background-color: transparent;\n border-color: #ff0d68;\n box-shadow: none;\n color: #ff0d68; }\n .button.is-primary.is-inverted.is-outlined {\n background-color: transparent;\n border-color: #fff;\n color: #fff; }\n .button.is-primary.is-inverted.is-outlined:hover, .button.is-primary.is-inverted.is-outlined.is-hovered, .button.is-primary.is-inverted.is-outlined:focus, .button.is-primary.is-inverted.is-outlined.is-focused {\n background-color: #fff;\n color: #ff0d68; }\n .button.is-primary.is-inverted.is-outlined.is-loading:hover::after, .button.is-primary.is-inverted.is-outlined.is-loading.is-hovered::after, .button.is-primary.is-inverted.is-outlined.is-loading:focus::after, .button.is-primary.is-inverted.is-outlined.is-loading.is-focused::after {\n border-color: transparent transparent #ff0d68 #ff0d68 !important; }\n .button.is-primary.is-inverted.is-outlined[disabled], fieldset[disabled] .button.is-primary.is-inverted.is-outlined {\n background-color: transparent;\n border-color: #fff;\n box-shadow: none;\n color: #fff; }\n .button.is-primary.is-light {\n background-color: #ffebf2;\n color: #e60056; }\n .button.is-primary.is-light:hover, .button.is-primary.is-light.is-hovered {\n background-color: #ffdeea;\n border-color: transparent;\n color: #e60056; }\n .button.is-primary.is-light:active, .button.is-primary.is-light.is-active {\n background-color: #ffd1e2;\n border-color: transparent;\n color: #e60056; }\n .button.is-link {\n background-color: #ff0d68;\n border-color: transparent;\n color: #fff; }\n .button.is-link:hover, .button.is-link.is-hovered {\n background-color: #ff0060;\n border-color: transparent;\n color: #fff; }\n .button.is-link:focus, .button.is-link.is-focused {\n border-color: transparent;\n color: #fff; }\n .button.is-link:focus:not(:active), .button.is-link.is-focused:not(:active) {\n box-shadow: 0 0 0 0.125em rgba(255, 13, 104, 0.25); }\n .button.is-link:active, .button.is-link.is-active {\n background-color: #f3005b;\n border-color: transparent;\n color: #fff; }\n .button.is-link[disabled], fieldset[disabled] .button.is-link {\n background-color: #ff0d68;\n border-color: #ff0d68;\n box-shadow: none; }\n .button.is-link.is-inverted {\n background-color: #fff;\n color: #ff0d68; }\n .button.is-link.is-inverted:hover, .button.is-link.is-inverted.is-hovered {\n background-color: #f2f2f2; }\n .button.is-link.is-inverted[disabled], fieldset[disabled] .button.is-link.is-inverted {\n background-color: #fff;\n border-color: transparent;\n box-shadow: none;\n color: #ff0d68; }\n .button.is-link.is-loading::after {\n border-color: transparent transparent #fff #fff !important; }\n .button.is-link.is-outlined {\n background-color: transparent;\n border-color: #ff0d68;\n color: #ff0d68; }\n .button.is-link.is-outlined:hover, .button.is-link.is-outlined.is-hovered, .button.is-link.is-outlined:focus, .button.is-link.is-outlined.is-focused {\n background-color: #ff0d68;\n border-color: #ff0d68;\n color: #fff; }\n .button.is-link.is-outlined.is-loading::after {\n border-color: transparent transparent #ff0d68 #ff0d68 !important; }\n .button.is-link.is-outlined.is-loading:hover::after, .button.is-link.is-outlined.is-loading.is-hovered::after, .button.is-link.is-outlined.is-loading:focus::after, .button.is-link.is-outlined.is-loading.is-focused::after {\n border-color: transparent transparent #fff #fff !important; }\n .button.is-link.is-outlined[disabled], fieldset[disabled] .button.is-link.is-outlined {\n background-color: transparent;\n border-color: #ff0d68;\n box-shadow: none;\n color: #ff0d68; }\n .button.is-link.is-inverted.is-outlined {\n background-color: transparent;\n border-color: #fff;\n color: #fff; }\n .button.is-link.is-inverted.is-outlined:hover, .button.is-link.is-inverted.is-outlined.is-hovered, .button.is-link.is-inverted.is-outlined:focus, .button.is-link.is-inverted.is-outlined.is-focused {\n background-color: #fff;\n color: #ff0d68; }\n .button.is-link.is-inverted.is-outlined.is-loading:hover::after, .button.is-link.is-inverted.is-outlined.is-loading.is-hovered::after, .button.is-link.is-inverted.is-outlined.is-loading:focus::after, .button.is-link.is-inverted.is-outlined.is-loading.is-focused::after {\n border-color: transparent transparent #ff0d68 #ff0d68 !important; }\n .button.is-link.is-inverted.is-outlined[disabled], fieldset[disabled] .button.is-link.is-inverted.is-outlined {\n background-color: transparent;\n border-color: #fff;\n box-shadow: none;\n color: #fff; }\n .button.is-link.is-light {\n background-color: #ffebf2;\n color: #e60056; }\n .button.is-link.is-light:hover, .button.is-link.is-light.is-hovered {\n background-color: #ffdeea;\n border-color: transparent;\n color: #e60056; }\n .button.is-link.is-light:active, .button.is-link.is-light.is-active {\n background-color: #ffd1e2;\n border-color: transparent;\n color: #e60056; }\n .button.is-info {\n background-color: #0092FF;\n border-color: transparent;\n color: #fff; }\n .button.is-info:hover, .button.is-info.is-hovered {\n background-color: #008bf2;\n border-color: transparent;\n color: #fff; }\n .button.is-info:focus, .button.is-info.is-focused {\n border-color: transparent;\n color: #fff; }\n .button.is-info:focus:not(:active), .button.is-info.is-focused:not(:active) {\n box-shadow: 0 0 0 0.125em rgba(0, 146, 255, 0.25); }\n .button.is-info:active, .button.is-info.is-active {\n background-color: #0083e6;\n border-color: transparent;\n color: #fff; }\n .button.is-info[disabled], fieldset[disabled] .button.is-info {\n background-color: #0092FF;\n border-color: #0092FF;\n box-shadow: none; }\n .button.is-info.is-inverted {\n background-color: #fff;\n color: #0092FF; }\n .button.is-info.is-inverted:hover, .button.is-info.is-inverted.is-hovered {\n background-color: #f2f2f2; }\n .button.is-info.is-inverted[disabled], fieldset[disabled] .button.is-info.is-inverted {\n background-color: #fff;\n border-color: transparent;\n box-shadow: none;\n color: #0092FF; }\n .button.is-info.is-loading::after {\n border-color: transparent transparent #fff #fff !important; }\n .button.is-info.is-outlined {\n background-color: transparent;\n border-color: #0092FF;\n color: #0092FF; }\n .button.is-info.is-outlined:hover, .button.is-info.is-outlined.is-hovered, .button.is-info.is-outlined:focus, .button.is-info.is-outlined.is-focused {\n background-color: #0092FF;\n border-color: #0092FF;\n color: #fff; }\n .button.is-info.is-outlined.is-loading::after {\n border-color: transparent transparent #0092FF #0092FF !important; }\n .button.is-info.is-outlined.is-loading:hover::after, .button.is-info.is-outlined.is-loading.is-hovered::after, .button.is-info.is-outlined.is-loading:focus::after, .button.is-info.is-outlined.is-loading.is-focused::after {\n border-color: transparent transparent #fff #fff !important; }\n .button.is-info.is-outlined[disabled], fieldset[disabled] .button.is-info.is-outlined {\n background-color: transparent;\n border-color: #0092FF;\n box-shadow: none;\n color: #0092FF; }\n .button.is-info.is-inverted.is-outlined {\n background-color: transparent;\n border-color: #fff;\n color: #fff; }\n .button.is-info.is-inverted.is-outlined:hover, .button.is-info.is-inverted.is-outlined.is-hovered, .button.is-info.is-inverted.is-outlined:focus, .button.is-info.is-inverted.is-outlined.is-focused {\n background-color: #fff;\n color: #0092FF; }\n .button.is-info.is-inverted.is-outlined.is-loading:hover::after, .button.is-info.is-inverted.is-outlined.is-loading.is-hovered::after, .button.is-info.is-inverted.is-outlined.is-loading:focus::after, .button.is-info.is-inverted.is-outlined.is-loading.is-focused::after {\n border-color: transparent transparent #0092FF #0092FF !important; }\n .button.is-info.is-inverted.is-outlined[disabled], fieldset[disabled] .button.is-info.is-inverted.is-outlined {\n background-color: transparent;\n border-color: #fff;\n box-shadow: none;\n color: #fff; }\n .button.is-info.is-light {\n background-color: #ebf6ff;\n color: #0075cc; }\n .button.is-info.is-light:hover, .button.is-info.is-light.is-hovered {\n background-color: #def1ff;\n border-color: transparent;\n color: #0075cc; }\n .button.is-info.is-light:active, .button.is-info.is-light.is-active {\n background-color: #d1ebff;\n border-color: transparent;\n color: #0075cc; }\n .button.is-success {\n background-color: #16DB93;\n border-color: transparent;\n color: rgba(0, 0, 0, 0.7); }\n .button.is-success:hover, .button.is-success.is-hovered {\n background-color: #15cf8b;\n border-color: transparent;\n color: rgba(0, 0, 0, 0.7); }\n .button.is-success:focus, .button.is-success.is-focused {\n border-color: transparent;\n color: rgba(0, 0, 0, 0.7); }\n .button.is-success:focus:not(:active), .button.is-success.is-focused:not(:active) {\n box-shadow: 0 0 0 0.125em rgba(22, 219, 147, 0.25); }\n .button.is-success:active, .button.is-success.is-active {\n background-color: #14c483;\n border-color: transparent;\n color: rgba(0, 0, 0, 0.7); }\n .button.is-success[disabled], fieldset[disabled] .button.is-success {\n background-color: #16DB93;\n border-color: #16DB93;\n box-shadow: none; }\n .button.is-success.is-inverted {\n background-color: rgba(0, 0, 0, 0.7);\n color: #16DB93; }\n .button.is-success.is-inverted:hover, .button.is-success.is-inverted.is-hovered {\n background-color: rgba(0, 0, 0, 0.7); }\n .button.is-success.is-inverted[disabled], fieldset[disabled] .button.is-success.is-inverted {\n background-color: rgba(0, 0, 0, 0.7);\n border-color: transparent;\n box-shadow: none;\n color: #16DB93; }\n .button.is-success.is-loading::after {\n border-color: transparent transparent rgba(0, 0, 0, 0.7) rgba(0, 0, 0, 0.7) !important; }\n .button.is-success.is-outlined {\n background-color: transparent;\n border-color: #16DB93;\n color: #16DB93; }\n .button.is-success.is-outlined:hover, .button.is-success.is-outlined.is-hovered, .button.is-success.is-outlined:focus, .button.is-success.is-outlined.is-focused {\n background-color: #16DB93;\n border-color: #16DB93;\n color: rgba(0, 0, 0, 0.7); }\n .button.is-success.is-outlined.is-loading::after {\n border-color: transparent transparent #16DB93 #16DB93 !important; }\n .button.is-success.is-outlined.is-loading:hover::after, .button.is-success.is-outlined.is-loading.is-hovered::after, .button.is-success.is-outlined.is-loading:focus::after, .button.is-success.is-outlined.is-loading.is-focused::after {\n border-color: transparent transparent rgba(0, 0, 0, 0.7) rgba(0, 0, 0, 0.7) !important; }\n .button.is-success.is-outlined[disabled], fieldset[disabled] .button.is-success.is-outlined {\n background-color: transparent;\n border-color: #16DB93;\n box-shadow: none;\n color: #16DB93; }\n .button.is-success.is-inverted.is-outlined {\n background-color: transparent;\n border-color: rgba(0, 0, 0, 0.7);\n color: rgba(0, 0, 0, 0.7); }\n .button.is-success.is-inverted.is-outlined:hover, .button.is-success.is-inverted.is-outlined.is-hovered, .button.is-success.is-inverted.is-outlined:focus, .button.is-success.is-inverted.is-outlined.is-focused {\n background-color: rgba(0, 0, 0, 0.7);\n color: #16DB93; }\n .button.is-success.is-inverted.is-outlined.is-loading:hover::after, .button.is-success.is-inverted.is-outlined.is-loading.is-hovered::after, .button.is-success.is-inverted.is-outlined.is-loading:focus::after, .button.is-success.is-inverted.is-outlined.is-loading.is-focused::after {\n border-color: transparent transparent #16DB93 #16DB93 !important; }\n .button.is-success.is-inverted.is-outlined[disabled], fieldset[disabled] .button.is-success.is-inverted.is-outlined {\n background-color: transparent;\n border-color: rgba(0, 0, 0, 0.7);\n box-shadow: none;\n color: rgba(0, 0, 0, 0.7); }\n .button.is-success.is-light {\n background-color: #ecfdf7;\n color: #0e865a; }\n .button.is-success.is-light:hover, .button.is-success.is-light.is-hovered {\n background-color: #e1fcf2;\n border-color: transparent;\n color: #0e865a; }\n .button.is-success.is-light:active, .button.is-success.is-light.is-active {\n background-color: #d5fbed;\n border-color: transparent;\n color: #0e865a; }\n .button.is-warning {\n background-color: #FFE900;\n border-color: transparent;\n color: rgba(0, 0, 0, 0.7); }\n .button.is-warning:hover, .button.is-warning.is-hovered {\n background-color: #f2dd00;\n border-color: transparent;\n color: rgba(0, 0, 0, 0.7); }\n .button.is-warning:focus, .button.is-warning.is-focused {\n border-color: transparent;\n color: rgba(0, 0, 0, 0.7); }\n .button.is-warning:focus:not(:active), .button.is-warning.is-focused:not(:active) {\n box-shadow: 0 0 0 0.125em rgba(255, 233, 0, 0.25); }\n .button.is-warning:active, .button.is-warning.is-active {\n background-color: #e6d200;\n border-color: transparent;\n color: rgba(0, 0, 0, 0.7); }\n .button.is-warning[disabled], fieldset[disabled] .button.is-warning {\n background-color: #FFE900;\n border-color: #FFE900;\n box-shadow: none; }\n .button.is-warning.is-inverted {\n background-color: rgba(0, 0, 0, 0.7);\n color: #FFE900; }\n .button.is-warning.is-inverted:hover, .button.is-warning.is-inverted.is-hovered {\n background-color: rgba(0, 0, 0, 0.7); }\n .button.is-warning.is-inverted[disabled], fieldset[disabled] .button.is-warning.is-inverted {\n background-color: rgba(0, 0, 0, 0.7);\n border-color: transparent;\n box-shadow: none;\n color: #FFE900; }\n .button.is-warning.is-loading::after {\n border-color: transparent transparent rgba(0, 0, 0, 0.7) rgba(0, 0, 0, 0.7) !important; }\n .button.is-warning.is-outlined {\n background-color: transparent;\n border-color: #FFE900;\n color: #FFE900; }\n .button.is-warning.is-outlined:hover, .button.is-warning.is-outlined.is-hovered, .button.is-warning.is-outlined:focus, .button.is-warning.is-outlined.is-focused {\n background-color: #FFE900;\n border-color: #FFE900;\n color: rgba(0, 0, 0, 0.7); }\n .button.is-warning.is-outlined.is-loading::after {\n border-color: transparent transparent #FFE900 #FFE900 !important; }\n .button.is-warning.is-outlined.is-loading:hover::after, .button.is-warning.is-outlined.is-loading.is-hovered::after, .button.is-warning.is-outlined.is-loading:focus::after, .button.is-warning.is-outlined.is-loading.is-focused::after {\n border-color: transparent transparent rgba(0, 0, 0, 0.7) rgba(0, 0, 0, 0.7) !important; }\n .button.is-warning.is-outlined[disabled], fieldset[disabled] .button.is-warning.is-outlined {\n background-color: transparent;\n border-color: #FFE900;\n box-shadow: none;\n color: #FFE900; }\n .button.is-warning.is-inverted.is-outlined {\n background-color: transparent;\n border-color: rgba(0, 0, 0, 0.7);\n color: rgba(0, 0, 0, 0.7); }\n .button.is-warning.is-inverted.is-outlined:hover, .button.is-warning.is-inverted.is-outlined.is-hovered, .button.is-warning.is-inverted.is-outlined:focus, .button.is-warning.is-inverted.is-outlined.is-focused {\n background-color: rgba(0, 0, 0, 0.7);\n color: #FFE900; }\n .button.is-warning.is-inverted.is-outlined.is-loading:hover::after, .button.is-warning.is-inverted.is-outlined.is-loading.is-hovered::after, .button.is-warning.is-inverted.is-outlined.is-loading:focus::after, .button.is-warning.is-inverted.is-outlined.is-loading.is-focused::after {\n border-color: transparent transparent #FFE900 #FFE900 !important; }\n .button.is-warning.is-inverted.is-outlined[disabled], fieldset[disabled] .button.is-warning.is-inverted.is-outlined {\n background-color: transparent;\n border-color: rgba(0, 0, 0, 0.7);\n box-shadow: none;\n color: rgba(0, 0, 0, 0.7); }\n .button.is-warning.is-light {\n background-color: #fffdeb;\n color: #948700; }\n .button.is-warning.is-light:hover, .button.is-warning.is-light.is-hovered {\n background-color: #fffcde;\n border-color: transparent;\n color: #948700; }\n .button.is-warning.is-light:active, .button.is-warning.is-light.is-active {\n background-color: #fffbd1;\n border-color: transparent;\n color: #948700; }\n .button.is-danger {\n background-color: #f14668;\n border-color: transparent;\n color: #fff; }\n .button.is-danger:hover, .button.is-danger.is-hovered {\n background-color: #f03a5f;\n border-color: transparent;\n color: #fff; }\n .button.is-danger:focus, .button.is-danger.is-focused {\n border-color: transparent;\n color: #fff; }\n .button.is-danger:focus:not(:active), .button.is-danger.is-focused:not(:active) {\n box-shadow: 0 0 0 0.125em rgba(241, 70, 104, 0.25); }\n .button.is-danger:active, .button.is-danger.is-active {\n background-color: #ef2e55;\n border-color: transparent;\n color: #fff; }\n .button.is-danger[disabled], fieldset[disabled] .button.is-danger {\n background-color: #f14668;\n border-color: #f14668;\n box-shadow: none; }\n .button.is-danger.is-inverted {\n background-color: #fff;\n color: #f14668; }\n .button.is-danger.is-inverted:hover, .button.is-danger.is-inverted.is-hovered {\n background-color: #f2f2f2; }\n .button.is-danger.is-inverted[disabled], fieldset[disabled] .button.is-danger.is-inverted {\n background-color: #fff;\n border-color: transparent;\n box-shadow: none;\n color: #f14668; }\n .button.is-danger.is-loading::after {\n border-color: transparent transparent #fff #fff !important; }\n .button.is-danger.is-outlined {\n background-color: transparent;\n border-color: #f14668;\n color: #f14668; }\n .button.is-danger.is-outlined:hover, .button.is-danger.is-outlined.is-hovered, .button.is-danger.is-outlined:focus, .button.is-danger.is-outlined.is-focused {\n background-color: #f14668;\n border-color: #f14668;\n color: #fff; }\n .button.is-danger.is-outlined.is-loading::after {\n border-color: transparent transparent #f14668 #f14668 !important; }\n .button.is-danger.is-outlined.is-loading:hover::after, .button.is-danger.is-outlined.is-loading.is-hovered::after, .button.is-danger.is-outlined.is-loading:focus::after, .button.is-danger.is-outlined.is-loading.is-focused::after {\n border-color: transparent transparent #fff #fff !important; }\n .button.is-danger.is-outlined[disabled], fieldset[disabled] .button.is-danger.is-outlined {\n background-color: transparent;\n border-color: #f14668;\n box-shadow: none;\n color: #f14668; }\n .button.is-danger.is-inverted.is-outlined {\n background-color: transparent;\n border-color: #fff;\n color: #fff; }\n .button.is-danger.is-inverted.is-outlined:hover, .button.is-danger.is-inverted.is-outlined.is-hovered, .button.is-danger.is-inverted.is-outlined:focus, .button.is-danger.is-inverted.is-outlined.is-focused {\n background-color: #fff;\n color: #f14668; }\n .button.is-danger.is-inverted.is-outlined.is-loading:hover::after, .button.is-danger.is-inverted.is-outlined.is-loading.is-hovered::after, .button.is-danger.is-inverted.is-outlined.is-loading:focus::after, .button.is-danger.is-inverted.is-outlined.is-loading.is-focused::after {\n border-color: transparent transparent #f14668 #f14668 !important; }\n .button.is-danger.is-inverted.is-outlined[disabled], fieldset[disabled] .button.is-danger.is-inverted.is-outlined {\n background-color: transparent;\n border-color: #fff;\n box-shadow: none;\n color: #fff; }\n .button.is-danger.is-light {\n background-color: #feecf0;\n color: #cc0f35; }\n .button.is-danger.is-light:hover, .button.is-danger.is-light.is-hovered {\n background-color: #fde0e6;\n border-color: transparent;\n color: #cc0f35; }\n .button.is-danger.is-light:active, .button.is-danger.is-light.is-active {\n background-color: #fcd4dc;\n border-color: transparent;\n color: #cc0f35; }\n .button.is-small {\n font-size: 0.75rem; }\n .button.is-small:not(.is-rounded) {\n border-radius: 2px; }\n .button.is-normal {\n font-size: 1rem; }\n .button.is-medium {\n font-size: 1.25rem; }\n .button.is-large {\n font-size: 1.5rem; }\n .button[disabled], fieldset[disabled] .button {\n background-color: white;\n border-color: #dbdbdb;\n box-shadow: none;\n opacity: 0.5; }\n .button.is-fullwidth {\n display: flex;\n width: 100%; }\n .button.is-loading {\n color: transparent !important;\n pointer-events: none; }\n .button.is-loading::after {\n position: absolute;\n left: calc(50% - (1em * 0.5));\n top: calc(50% - (1em * 0.5));\n position: absolute !important; }\n .button.is-static {\n background-color: whitesmoke;\n border-color: #dbdbdb;\n color: #7a7a7a;\n box-shadow: none;\n pointer-events: none; }\n .button.is-rounded {\n border-radius: 9999px;\n padding-left: calc(1em + 0.25em);\n padding-right: calc(1em + 0.25em); }\n\n.buttons {\n align-items: center;\n display: flex;\n flex-wrap: wrap;\n justify-content: flex-start; }\n .buttons .button {\n margin-bottom: 0.5rem; }\n .buttons .button:not(:last-child):not(.is-fullwidth) {\n margin-right: 0.5rem; }\n .buttons:last-child {\n margin-bottom: -0.5rem; }\n .buttons:not(:last-child) {\n margin-bottom: 1rem; }\n .buttons.are-small .button:not(.is-normal):not(.is-medium):not(.is-large) {\n font-size: 0.75rem; }\n .buttons.are-small .button:not(.is-normal):not(.is-medium):not(.is-large):not(.is-rounded) {\n border-radius: 2px; }\n .buttons.are-medium .button:not(.is-small):not(.is-normal):not(.is-large) {\n font-size: 1.25rem; }\n .buttons.are-large .button:not(.is-small):not(.is-normal):not(.is-medium) {\n font-size: 1.5rem; }\n .buttons.has-addons .button:not(:first-child) {\n border-bottom-left-radius: 0;\n border-top-left-radius: 0; }\n .buttons.has-addons .button:not(:last-child) {\n border-bottom-right-radius: 0;\n border-top-right-radius: 0;\n margin-right: -1px; }\n .buttons.has-addons .button:last-child {\n margin-right: 0; }\n .buttons.has-addons .button:hover, .buttons.has-addons .button.is-hovered {\n z-index: 2; }\n .buttons.has-addons .button:focus, .buttons.has-addons .button.is-focused, .buttons.has-addons .button:active, .buttons.has-addons .button.is-active, .buttons.has-addons .button.is-selected {\n z-index: 3; }\n .buttons.has-addons .button:focus:hover, .buttons.has-addons .button.is-focused:hover, .buttons.has-addons .button:active:hover, .buttons.has-addons .button.is-active:hover, .buttons.has-addons .button.is-selected:hover {\n z-index: 4; }\n .buttons.has-addons .button.is-expanded {\n flex-grow: 1;\n flex-shrink: 1; }\n .buttons.is-centered {\n justify-content: center; }\n .buttons.is-centered:not(.has-addons) .button:not(.is-fullwidth) {\n margin-left: 0.25rem;\n margin-right: 0.25rem; }\n .buttons.is-right {\n justify-content: flex-end; }\n .buttons.is-right:not(.has-addons) .button:not(.is-fullwidth) {\n margin-left: 0.25rem;\n margin-right: 0.25rem; }\n\n@media screen and (max-width: 768px) {\n .button.is-responsive.is-small {\n font-size: 0.5625rem; }\n .button.is-responsive,\n .button.is-responsive.is-normal {\n font-size: 0.65625rem; }\n .button.is-responsive.is-medium {\n font-size: 0.75rem; }\n .button.is-responsive.is-large {\n font-size: 1rem; } }\n\n@media screen and (min-width: 769px) and (max-width: 1023px) {\n .button.is-responsive.is-small {\n font-size: 0.65625rem; }\n .button.is-responsive,\n .button.is-responsive.is-normal {\n font-size: 0.75rem; }\n .button.is-responsive.is-medium {\n font-size: 1rem; }\n .button.is-responsive.is-large {\n font-size: 1.25rem; } }\n\n.container {\n flex-grow: 1;\n margin: 0 auto;\n position: relative;\n width: auto; }\n .container.is-fluid {\n max-width: none !important;\n padding-left: 32px;\n padding-right: 32px;\n width: 100%; }\n @media screen and (min-width: 1024px) {\n .container {\n max-width: 960px; } }\n @media screen and (max-width: 1215px) {\n .container.is-widescreen:not(.is-max-desktop) {\n max-width: 1152px; } }\n @media screen and (max-width: 1407px) {\n .container.is-fullhd:not(.is-max-desktop):not(.is-max-widescreen) {\n max-width: 1344px; } }\n @media screen and (min-width: 1216px) {\n .container:not(.is-max-desktop) {\n max-width: 1152px; } }\n @media screen and (min-width: 1408px) {\n .container:not(.is-max-desktop):not(.is-max-widescreen) {\n max-width: 1344px; } }\n.content li + li {\n margin-top: 0.25em; }\n\n.content p:not(:last-child),\n.content dl:not(:last-child),\n.content ol:not(:last-child),\n.content ul:not(:last-child),\n.content blockquote:not(:last-child),\n.content pre:not(:last-child),\n.content table:not(:last-child) {\n margin-bottom: 1em; }\n\n.content h1,\n.content h2,\n.content h3,\n.content h4,\n.content h5,\n.content h6 {\n color: #363636;\n font-weight: 600;\n line-height: 1.125; }\n\n.content h1 {\n font-size: 2em;\n margin-bottom: 0.5em; }\n .content h1:not(:first-child) {\n margin-top: 1em; }\n\n.content h2 {\n font-size: 1.75em;\n margin-bottom: 0.5714em; }\n .content h2:not(:first-child) {\n margin-top: 1.1428em; }\n\n.content h3 {\n font-size: 1.5em;\n margin-bottom: 0.6666em; }\n .content h3:not(:first-child) {\n margin-top: 1.3333em; }\n\n.content h4 {\n font-size: 1.25em;\n margin-bottom: 0.8em; }\n\n.content h5 {\n font-size: 1.125em;\n margin-bottom: 0.8888em; }\n\n.content h6 {\n font-size: 1em;\n margin-bottom: 1em; }\n\n.content blockquote {\n background-color: whitesmoke;\n border-left: 5px solid #dbdbdb;\n padding: 1.25em 1.5em; }\n\n.content ol {\n list-style-position: outside;\n margin-left: 2em;\n margin-top: 1em; }\n .content ol:not([type]) {\n list-style-type: decimal; }\n .content ol:not([type]).is-lower-alpha {\n list-style-type: lower-alpha; }\n .content ol:not([type]).is-lower-roman {\n list-style-type: lower-roman; }\n .content ol:not([type]).is-upper-alpha {\n list-style-type: upper-alpha; }\n .content ol:not([type]).is-upper-roman {\n list-style-type: upper-roman; }\n\n.content ul {\n list-style: disc outside;\n margin-left: 2em;\n margin-top: 1em; }\n .content ul ul {\n list-style-type: circle;\n margin-top: 0.5em; }\n .content ul ul ul {\n list-style-type: square; }\n\n.content dd {\n margin-left: 2em; }\n\n.content figure {\n margin-left: 2em;\n margin-right: 2em;\n text-align: center; }\n .content figure:not(:first-child) {\n margin-top: 2em; }\n .content figure:not(:last-child) {\n margin-bottom: 2em; }\n .content figure img {\n display: inline-block; }\n .content figure figcaption {\n font-style: italic; }\n\n.content pre {\n -webkit-overflow-scrolling: touch;\n overflow-x: auto;\n padding: 1.25em 1.5em;\n white-space: pre;\n word-wrap: normal; }\n\n.content sup,\n.content sub {\n font-size: 75%; }\n\n.content table {\n width: 100%; }\n .content table td,\n .content table th {\n border: 1px solid #dbdbdb;\n border-width: 0 0 1px;\n padding: 0.5em 0.75em;\n vertical-align: top; }\n .content table th {\n color: #363636; }\n .content table th:not([align]) {\n text-align: inherit; }\n .content table thead td,\n .content table thead th {\n border-width: 0 0 2px;\n color: #363636; }\n .content table tfoot td,\n .content table tfoot th {\n border-width: 2px 0 0;\n color: #363636; }\n .content table tbody tr:last-child td,\n .content table tbody tr:last-child th {\n border-bottom-width: 0; }\n\n.content .tabs li + li {\n margin-top: 0; }\n\n.content.is-small {\n font-size: 0.75rem; }\n\n.content.is-normal {\n font-size: 1rem; }\n\n.content.is-medium {\n font-size: 1.25rem; }\n\n.content.is-large {\n font-size: 1.5rem; }\n\n.icon {\n align-items: center;\n display: inline-flex;\n justify-content: center;\n height: 1.5rem;\n width: 1.5rem; }\n .icon.is-small {\n height: 1rem;\n width: 1rem; }\n .icon.is-medium {\n height: 2rem;\n width: 2rem; }\n .icon.is-large {\n height: 3rem;\n width: 3rem; }\n\n.icon-text {\n align-items: flex-start;\n color: inherit;\n display: inline-flex;\n flex-wrap: wrap;\n line-height: 1.5rem;\n vertical-align: top; }\n .icon-text .icon {\n flex-grow: 0;\n flex-shrink: 0; }\n .icon-text .icon:not(:last-child) {\n margin-right: 0.25em; }\n .icon-text .icon:not(:first-child) {\n margin-left: 0.25em; }\n\ndiv.icon-text {\n display: flex; }\n\n.image {\n display: block;\n position: relative; }\n .image img {\n display: block;\n height: auto;\n width: 100%; }\n .image img.is-rounded {\n border-radius: 9999px; }\n .image.is-fullwidth {\n width: 100%; }\n .image.is-square img,\n .image.is-square .has-ratio, .image.is-1by1 img,\n .image.is-1by1 .has-ratio, .image.is-5by4 img,\n .image.is-5by4 .has-ratio, .image.is-4by3 img,\n .image.is-4by3 .has-ratio, .image.is-3by2 img,\n .image.is-3by2 .has-ratio, .image.is-5by3 img,\n .image.is-5by3 .has-ratio, .image.is-16by9 img,\n .image.is-16by9 .has-ratio, .image.is-2by1 img,\n .image.is-2by1 .has-ratio, .image.is-3by1 img,\n .image.is-3by1 .has-ratio, .image.is-4by5 img,\n .image.is-4by5 .has-ratio, .image.is-3by4 img,\n .image.is-3by4 .has-ratio, .image.is-2by3 img,\n .image.is-2by3 .has-ratio, .image.is-3by5 img,\n .image.is-3by5 .has-ratio, .image.is-9by16 img,\n .image.is-9by16 .has-ratio, .image.is-1by2 img,\n .image.is-1by2 .has-ratio, .image.is-1by3 img,\n .image.is-1by3 .has-ratio {\n height: 100%;\n width: 100%; }\n .image.is-square, .image.is-1by1 {\n padding-top: 100%; }\n .image.is-5by4 {\n padding-top: 80%; }\n .image.is-4by3 {\n padding-top: 75%; }\n .image.is-3by2 {\n padding-top: 66.6666%; }\n .image.is-5by3 {\n padding-top: 60%; }\n .image.is-16by9 {\n padding-top: 56.25%; }\n .image.is-2by1 {\n padding-top: 50%; }\n .image.is-3by1 {\n padding-top: 33.3333%; }\n .image.is-4by5 {\n padding-top: 125%; }\n .image.is-3by4 {\n padding-top: 133.3333%; }\n .image.is-2by3 {\n padding-top: 150%; }\n .image.is-3by5 {\n padding-top: 166.6666%; }\n .image.is-9by16 {\n padding-top: 177.7777%; }\n .image.is-1by2 {\n padding-top: 200%; }\n .image.is-1by3 {\n padding-top: 300%; }\n .image.is-16x16 {\n height: 16px;\n width: 16px; }\n .image.is-24x24 {\n height: 24px;\n width: 24px; }\n .image.is-32x32 {\n height: 32px;\n width: 32px; }\n .image.is-48x48 {\n height: 48px;\n width: 48px; }\n .image.is-64x64 {\n height: 64px;\n width: 64px; }\n .image.is-96x96 {\n height: 96px;\n width: 96px; }\n .image.is-128x128 {\n height: 128px;\n width: 128px; }\n\n.notification {\n background-color: whitesmoke;\n border-radius: 4px;\n position: relative;\n padding: 1.25rem 2.5rem 1.25rem 1.5rem; }\n .notification a:not(.button):not(.dropdown-item) {\n color: currentColor;\n text-decoration: underline; }\n .notification strong {\n color: currentColor; }\n .notification code,\n .notification pre {\n background: white; }\n .notification pre code {\n background: transparent; }\n .notification > .delete {\n right: 0.5rem;\n position: absolute;\n top: 0.5rem; }\n .notification .title,\n .notification .subtitle,\n .notification .content {\n color: currentColor; }\n .notification.is-white {\n background-color: white;\n color: #0a0a0a; }\n .notification.is-black {\n background-color: #0a0a0a;\n color: white; }\n .notification.is-light {\n background-color: whitesmoke;\n color: rgba(0, 0, 0, 0.7); }\n .notification.is-dark {\n background-color: #363636;\n color: #fff; }\n .notification.is-primary {\n background-color: #ff0d68;\n color: #fff; }\n .notification.is-primary.is-light {\n background-color: #ffebf2;\n color: #e60056; }\n .notification.is-link {\n background-color: #ff0d68;\n color: #fff; }\n .notification.is-link.is-light {\n background-color: #ffebf2;\n color: #e60056; }\n .notification.is-info {\n background-color: #0092FF;\n color: #fff; }\n .notification.is-info.is-light {\n background-color: #ebf6ff;\n color: #0075cc; }\n .notification.is-success {\n background-color: #16DB93;\n color: rgba(0, 0, 0, 0.7); }\n .notification.is-success.is-light {\n background-color: #ecfdf7;\n color: #0e865a; }\n .notification.is-warning {\n background-color: #FFE900;\n color: rgba(0, 0, 0, 0.7); }\n .notification.is-warning.is-light {\n background-color: #fffdeb;\n color: #948700; }\n .notification.is-danger {\n background-color: #f14668;\n color: #fff; }\n .notification.is-danger.is-light {\n background-color: #feecf0;\n color: #cc0f35; }\n\n.progress {\n -moz-appearance: none;\n -webkit-appearance: none;\n border: none;\n border-radius: 9999px;\n display: block;\n height: 1rem;\n overflow: hidden;\n padding: 0;\n width: 100%; }\n .progress::-webkit-progress-bar {\n background-color: #ededed; }\n .progress::-webkit-progress-value {\n background-color: #4a4a4a; }\n .progress::-moz-progress-bar {\n background-color: #4a4a4a; }\n .progress::-ms-fill {\n background-color: #4a4a4a;\n border: none; }\n .progress.is-white::-webkit-progress-value {\n background-color: white; }\n .progress.is-white::-moz-progress-bar {\n background-color: white; }\n .progress.is-white::-ms-fill {\n background-color: white; }\n .progress.is-white:indeterminate {\n background-image: linear-gradient(to right, white 30%, #ededed 30%); }\n .progress.is-black::-webkit-progress-value {\n background-color: #0a0a0a; }\n .progress.is-black::-moz-progress-bar {\n background-color: #0a0a0a; }\n .progress.is-black::-ms-fill {\n background-color: #0a0a0a; }\n .progress.is-black:indeterminate {\n background-image: linear-gradient(to right, #0a0a0a 30%, #ededed 30%); }\n .progress.is-light::-webkit-progress-value {\n background-color: whitesmoke; }\n .progress.is-light::-moz-progress-bar {\n background-color: whitesmoke; }\n .progress.is-light::-ms-fill {\n background-color: whitesmoke; }\n .progress.is-light:indeterminate {\n background-image: linear-gradient(to right, whitesmoke 30%, #ededed 30%); }\n .progress.is-dark::-webkit-progress-value {\n background-color: #363636; }\n .progress.is-dark::-moz-progress-bar {\n background-color: #363636; }\n .progress.is-dark::-ms-fill {\n background-color: #363636; }\n .progress.is-dark:indeterminate {\n background-image: linear-gradient(to right, #363636 30%, #ededed 30%); }\n .progress.is-primary::-webkit-progress-value {\n background-color: #ff0d68; }\n .progress.is-primary::-moz-progress-bar {\n background-color: #ff0d68; }\n .progress.is-primary::-ms-fill {\n background-color: #ff0d68; }\n .progress.is-primary:indeterminate {\n background-image: linear-gradient(to right, #ff0d68 30%, #ededed 30%); }\n .progress.is-link::-webkit-progress-value {\n background-color: #ff0d68; }\n .progress.is-link::-moz-progress-bar {\n background-color: #ff0d68; }\n .progress.is-link::-ms-fill {\n background-color: #ff0d68; }\n .progress.is-link:indeterminate {\n background-image: linear-gradient(to right, #ff0d68 30%, #ededed 30%); }\n .progress.is-info::-webkit-progress-value {\n background-color: #0092FF; }\n .progress.is-info::-moz-progress-bar {\n background-color: #0092FF; }\n .progress.is-info::-ms-fill {\n background-color: #0092FF; }\n .progress.is-info:indeterminate {\n background-image: linear-gradient(to right, #0092FF 30%, #ededed 30%); }\n .progress.is-success::-webkit-progress-value {\n background-color: #16DB93; }\n .progress.is-success::-moz-progress-bar {\n background-color: #16DB93; }\n .progress.is-success::-ms-fill {\n background-color: #16DB93; }\n .progress.is-success:indeterminate {\n background-image: linear-gradient(to right, #16DB93 30%, #ededed 30%); }\n .progress.is-warning::-webkit-progress-value {\n background-color: #FFE900; }\n .progress.is-warning::-moz-progress-bar {\n background-color: #FFE900; }\n .progress.is-warning::-ms-fill {\n background-color: #FFE900; }\n .progress.is-warning:indeterminate {\n background-image: linear-gradient(to right, #FFE900 30%, #ededed 30%); }\n .progress.is-danger::-webkit-progress-value {\n background-color: #f14668; }\n .progress.is-danger::-moz-progress-bar {\n background-color: #f14668; }\n .progress.is-danger::-ms-fill {\n background-color: #f14668; }\n .progress.is-danger:indeterminate {\n background-image: linear-gradient(to right, #f14668 30%, #ededed 30%); }\n .progress:indeterminate {\n animation-duration: 1.5s;\n animation-iteration-count: infinite;\n animation-name: moveIndeterminate;\n animation-timing-function: linear;\n background-color: #ededed;\n background-image: linear-gradient(to right, #4a4a4a 30%, #ededed 30%);\n background-position: top left;\n background-repeat: no-repeat;\n background-size: 150% 150%; }\n .progress:indeterminate::-webkit-progress-bar {\n background-color: transparent; }\n .progress:indeterminate::-moz-progress-bar {\n background-color: transparent; }\n .progress:indeterminate::-ms-fill {\n animation-name: none; }\n .progress.is-small {\n height: 0.75rem; }\n .progress.is-medium {\n height: 1.25rem; }\n .progress.is-large {\n height: 1.5rem; }\n\n@keyframes moveIndeterminate {\n from {\n background-position: 200% 0; }\n to {\n background-position: -200% 0; } }\n\n.table {\n background-color: white;\n color: #363636; }\n .table td,\n .table th {\n border: 1px solid #dbdbdb;\n border-width: 0 0 1px;\n padding: 0.5em 0.75em;\n vertical-align: top; }\n .table td.is-white,\n .table th.is-white {\n background-color: white;\n border-color: white;\n color: #0a0a0a; }\n .table td.is-black,\n .table th.is-black {\n background-color: #0a0a0a;\n border-color: #0a0a0a;\n color: white; }\n .table td.is-light,\n .table th.is-light {\n background-color: whitesmoke;\n border-color: whitesmoke;\n color: rgba(0, 0, 0, 0.7); }\n .table td.is-dark,\n .table th.is-dark {\n background-color: #363636;\n border-color: #363636;\n color: #fff; }\n .table td.is-primary,\n .table th.is-primary {\n background-color: #ff0d68;\n border-color: #ff0d68;\n color: #fff; }\n .table td.is-link,\n .table th.is-link {\n background-color: #ff0d68;\n border-color: #ff0d68;\n color: #fff; }\n .table td.is-info,\n .table th.is-info {\n background-color: #0092FF;\n border-color: #0092FF;\n color: #fff; }\n .table td.is-success,\n .table th.is-success {\n background-color: #16DB93;\n border-color: #16DB93;\n color: rgba(0, 0, 0, 0.7); }\n .table td.is-warning,\n .table th.is-warning {\n background-color: #FFE900;\n border-color: #FFE900;\n color: rgba(0, 0, 0, 0.7); }\n .table td.is-danger,\n .table th.is-danger {\n background-color: #f14668;\n border-color: #f14668;\n color: #fff; }\n .table td.is-narrow,\n .table th.is-narrow {\n white-space: nowrap;\n width: 1%; }\n .table td.is-selected,\n .table th.is-selected {\n background-color: #ff0d68;\n color: #fff; }\n .table td.is-selected a,\n .table td.is-selected strong,\n .table th.is-selected a,\n .table th.is-selected strong {\n color: currentColor; }\n .table td.is-vcentered,\n .table th.is-vcentered {\n vertical-align: middle; }\n .table th {\n color: #363636; }\n .table th:not([align]) {\n text-align: left; }\n .table tr.is-selected {\n background-color: #ff0d68;\n color: #fff; }\n .table tr.is-selected a,\n .table tr.is-selected strong {\n color: currentColor; }\n .table tr.is-selected td,\n .table tr.is-selected th {\n border-color: #fff;\n color: currentColor; }\n .table thead {\n background-color: transparent; }\n .table thead td,\n .table thead th {\n border-width: 0 0 2px;\n color: #363636; }\n .table tfoot {\n background-color: transparent; }\n .table tfoot td,\n .table tfoot th {\n border-width: 2px 0 0;\n color: #363636; }\n .table tbody {\n background-color: transparent; }\n .table tbody tr:last-child td,\n .table tbody tr:last-child th {\n border-bottom-width: 0; }\n .table.is-bordered td,\n .table.is-bordered th {\n border-width: 1px; }\n .table.is-bordered tr:last-child td,\n .table.is-bordered tr:last-child th {\n border-bottom-width: 1px; }\n .table.is-fullwidth {\n width: 100%; }\n .table.is-hoverable tbody tr:not(.is-selected):hover {\n background-color: #fafafa; }\n .table.is-hoverable.is-striped tbody tr:not(.is-selected):hover {\n background-color: #fafafa; }\n .table.is-hoverable.is-striped tbody tr:not(.is-selected):hover:nth-child(even) {\n background-color: whitesmoke; }\n .table.is-narrow td,\n .table.is-narrow th {\n padding: 0.25em 0.5em; }\n .table.is-striped tbody tr:not(.is-selected):nth-child(even) {\n background-color: #fafafa; }\n\n.table-container {\n -webkit-overflow-scrolling: touch;\n overflow: auto;\n overflow-y: hidden;\n max-width: 100%; }\n\n.tags {\n align-items: center;\n display: flex;\n flex-wrap: wrap;\n justify-content: flex-start; }\n .tags .tag {\n margin-bottom: 0.5rem; }\n .tags .tag:not(:last-child) {\n margin-right: 0.5rem; }\n .tags:last-child {\n margin-bottom: -0.5rem; }\n .tags:not(:last-child) {\n margin-bottom: 1rem; }\n .tags.are-medium .tag:not(.is-normal):not(.is-large) {\n font-size: 1rem; }\n .tags.are-large .tag:not(.is-normal):not(.is-medium) {\n font-size: 1.25rem; }\n .tags.is-centered {\n justify-content: center; }\n .tags.is-centered .tag {\n margin-right: 0.25rem;\n margin-left: 0.25rem; }\n .tags.is-right {\n justify-content: flex-end; }\n .tags.is-right .tag:not(:first-child) {\n margin-left: 0.5rem; }\n .tags.is-right .tag:not(:last-child) {\n margin-right: 0; }\n .tags.has-addons .tag {\n margin-right: 0; }\n .tags.has-addons .tag:not(:first-child) {\n margin-left: 0;\n border-top-left-radius: 0;\n border-bottom-left-radius: 0; }\n .tags.has-addons .tag:not(:last-child) {\n border-top-right-radius: 0;\n border-bottom-right-radius: 0; }\n\n.tag:not(body) {\n align-items: center;\n background-color: whitesmoke;\n border-radius: 4px;\n color: #4a4a4a;\n display: inline-flex;\n font-size: 0.75rem;\n height: 2em;\n justify-content: center;\n line-height: 1.5;\n padding-left: 0.75em;\n padding-right: 0.75em;\n white-space: nowrap; }\n .tag:not(body) .delete {\n margin-left: 0.25rem;\n margin-right: -0.375rem; }\n .tag:not(body).is-white {\n background-color: white;\n color: #0a0a0a; }\n .tag:not(body).is-black {\n background-color: #0a0a0a;\n color: white; }\n .tag:not(body).is-light {\n background-color: whitesmoke;\n color: rgba(0, 0, 0, 0.7); }\n .tag:not(body).is-dark {\n background-color: #363636;\n color: #fff; }\n .tag:not(body).is-primary {\n background-color: #ff0d68;\n color: #fff; }\n .tag:not(body).is-primary.is-light {\n background-color: #ffebf2;\n color: #e60056; }\n .tag:not(body).is-link {\n background-color: #ff0d68;\n color: #fff; }\n .tag:not(body).is-link.is-light {\n background-color: #ffebf2;\n color: #e60056; }\n .tag:not(body).is-info {\n background-color: #0092FF;\n color: #fff; }\n .tag:not(body).is-info.is-light {\n background-color: #ebf6ff;\n color: #0075cc; }\n .tag:not(body).is-success {\n background-color: #16DB93;\n color: rgba(0, 0, 0, 0.7); }\n .tag:not(body).is-success.is-light {\n background-color: #ecfdf7;\n color: #0e865a; }\n .tag:not(body).is-warning {\n background-color: #FFE900;\n color: rgba(0, 0, 0, 0.7); }\n .tag:not(body).is-warning.is-light {\n background-color: #fffdeb;\n color: #948700; }\n .tag:not(body).is-danger {\n background-color: #f14668;\n color: #fff; }\n .tag:not(body).is-danger.is-light {\n background-color: #feecf0;\n color: #cc0f35; }\n .tag:not(body).is-normal {\n font-size: 0.75rem; }\n .tag:not(body).is-medium {\n font-size: 1rem; }\n .tag:not(body).is-large {\n font-size: 1.25rem; }\n .tag:not(body) .icon:first-child:not(:last-child) {\n margin-left: -0.375em;\n margin-right: 0.1875em; }\n .tag:not(body) .icon:last-child:not(:first-child) {\n margin-left: 0.1875em;\n margin-right: -0.375em; }\n .tag:not(body) .icon:first-child:last-child {\n margin-left: -0.375em;\n margin-right: -0.375em; }\n .tag:not(body).is-delete {\n margin-left: 1px;\n padding: 0;\n position: relative;\n width: 2em; }\n .tag:not(body).is-delete::before, .tag:not(body).is-delete::after {\n background-color: currentColor;\n content: \"\";\n display: block;\n left: 50%;\n position: absolute;\n top: 50%;\n transform: translateX(-50%) translateY(-50%) rotate(45deg);\n transform-origin: center center; }\n .tag:not(body).is-delete::before {\n height: 1px;\n width: 50%; }\n .tag:not(body).is-delete::after {\n height: 50%;\n width: 1px; }\n .tag:not(body).is-delete:hover, .tag:not(body).is-delete:focus {\n background-color: #e8e8e8; }\n .tag:not(body).is-delete:active {\n background-color: #dbdbdb; }\n .tag:not(body).is-rounded {\n border-radius: 9999px; }\n\na.tag:hover {\n text-decoration: underline; }\n\n.title,\n.subtitle {\n word-break: break-word; }\n .title em,\n .title span,\n .subtitle em,\n .subtitle span {\n font-weight: inherit; }\n .title sub,\n .subtitle sub {\n font-size: 0.75em; }\n .title sup,\n .subtitle sup {\n font-size: 0.75em; }\n .title .tag,\n .subtitle .tag {\n vertical-align: middle; }\n\n.title {\n color: #363636;\n font-size: 2rem;\n font-weight: 600;\n line-height: 1.125; }\n .title strong {\n color: inherit;\n font-weight: inherit; }\n .title:not(.is-spaced) + .subtitle {\n margin-top: -1.25rem; }\n .title.is-1 {\n font-size: 3rem; }\n .title.is-2 {\n font-size: 2.5rem; }\n .title.is-3 {\n font-size: 2rem; }\n .title.is-4 {\n font-size: 1.5rem; }\n .title.is-5 {\n font-size: 1.25rem; }\n .title.is-6 {\n font-size: 1rem; }\n .title.is-7 {\n font-size: 0.75rem; }\n\n.subtitle {\n color: #4a4a4a;\n font-size: 1.25rem;\n font-weight: 400;\n line-height: 1.25; }\n .subtitle strong {\n color: #363636;\n font-weight: 600; }\n .subtitle:not(.is-spaced) + .title {\n margin-top: -1.25rem; }\n .subtitle.is-1 {\n font-size: 3rem; }\n .subtitle.is-2 {\n font-size: 2.5rem; }\n .subtitle.is-3 {\n font-size: 2rem; }\n .subtitle.is-4 {\n font-size: 1.5rem; }\n .subtitle.is-5 {\n font-size: 1.25rem; }\n .subtitle.is-6 {\n font-size: 1rem; }\n .subtitle.is-7 {\n font-size: 0.75rem; }\n\n.heading {\n display: block;\n font-size: 11px;\n letter-spacing: 1px;\n margin-bottom: 5px;\n text-transform: uppercase; }\n\n.number {\n align-items: center;\n background-color: whitesmoke;\n border-radius: 9999px;\n display: inline-flex;\n font-size: 1.25rem;\n height: 2em;\n justify-content: center;\n margin-right: 1.5rem;\n min-width: 2.5em;\n padding: 0.25rem 0.5rem;\n text-align: center;\n vertical-align: top; }\n\n/* Bulma Form */\n.select select, .textarea, .input {\n background-color: white;\n border-color: #dbdbdb;\n border-radius: 4px;\n color: #363636; }\n .select select::-moz-placeholder, .textarea::-moz-placeholder, .input::-moz-placeholder {\n color: rgba(54, 54, 54, 0.3); }\n .select select::-webkit-input-placeholder, .textarea::-webkit-input-placeholder, .input::-webkit-input-placeholder {\n color: rgba(54, 54, 54, 0.3); }\n .select select:-moz-placeholder, .textarea:-moz-placeholder, .input:-moz-placeholder {\n color: rgba(54, 54, 54, 0.3); }\n .select select:-ms-input-placeholder, .textarea:-ms-input-placeholder, .input:-ms-input-placeholder {\n color: rgba(54, 54, 54, 0.3); }\n .select select:hover, .textarea:hover, .input:hover, .select select.is-hovered, .is-hovered.textarea, .is-hovered.input {\n border-color: #b5b5b5; }\n .select select:focus, .textarea:focus, .input:focus, .select select.is-focused, .is-focused.textarea, .is-focused.input, .select select:active, .textarea:active, .input:active, .select select.is-active, .is-active.textarea, .is-active.input {\n border-color: #ff0d68;\n box-shadow: 0 0 0 0.125em rgba(255, 13, 104, 0.25); }\n .select select[disabled], [disabled].textarea, [disabled].input, fieldset[disabled] .select select, .select fieldset[disabled] select, fieldset[disabled] .textarea, fieldset[disabled] .input {\n background-color: whitesmoke;\n border-color: whitesmoke;\n box-shadow: none;\n color: #7a7a7a; }\n .select select[disabled]::-moz-placeholder, [disabled].textarea::-moz-placeholder, [disabled].input::-moz-placeholder, fieldset[disabled] .select select::-moz-placeholder, .select fieldset[disabled] select::-moz-placeholder, fieldset[disabled] .textarea::-moz-placeholder, fieldset[disabled] .input::-moz-placeholder {\n color: rgba(122, 122, 122, 0.3); }\n .select select[disabled]::-webkit-input-placeholder, [disabled].textarea::-webkit-input-placeholder, [disabled].input::-webkit-input-placeholder, fieldset[disabled] .select select::-webkit-input-placeholder, .select fieldset[disabled] select::-webkit-input-placeholder, fieldset[disabled] .textarea::-webkit-input-placeholder, fieldset[disabled] .input::-webkit-input-placeholder {\n color: rgba(122, 122, 122, 0.3); }\n .select select[disabled]:-moz-placeholder, [disabled].textarea:-moz-placeholder, [disabled].input:-moz-placeholder, fieldset[disabled] .select select:-moz-placeholder, .select fieldset[disabled] select:-moz-placeholder, fieldset[disabled] .textarea:-moz-placeholder, fieldset[disabled] .input:-moz-placeholder {\n color: rgba(122, 122, 122, 0.3); }\n .select select[disabled]:-ms-input-placeholder, [disabled].textarea:-ms-input-placeholder, [disabled].input:-ms-input-placeholder, fieldset[disabled] .select select:-ms-input-placeholder, .select fieldset[disabled] select:-ms-input-placeholder, fieldset[disabled] .textarea:-ms-input-placeholder, fieldset[disabled] .input:-ms-input-placeholder {\n color: rgba(122, 122, 122, 0.3); }\n\n.textarea, .input {\n box-shadow: inset 0 0.0625em 0.125em rgba(10, 10, 10, 0.05);\n max-width: 100%;\n width: 100%; }\n [readonly].textarea, [readonly].input {\n box-shadow: none; }\n .is-white.textarea, .is-white.input {\n border-color: white; }\n .is-white.textarea:focus, .is-white.input:focus, .is-white.is-focused.textarea, .is-white.is-focused.input, .is-white.textarea:active, .is-white.input:active, .is-white.is-active.textarea, .is-white.is-active.input {\n box-shadow: 0 0 0 0.125em rgba(255, 255, 255, 0.25); }\n .is-black.textarea, .is-black.input {\n border-color: #0a0a0a; }\n .is-black.textarea:focus, .is-black.input:focus, .is-black.is-focused.textarea, .is-black.is-focused.input, .is-black.textarea:active, .is-black.input:active, .is-black.is-active.textarea, .is-black.is-active.input {\n box-shadow: 0 0 0 0.125em rgba(10, 10, 10, 0.25); }\n .is-light.textarea, .is-light.input {\n border-color: whitesmoke; }\n .is-light.textarea:focus, .is-light.input:focus, .is-light.is-focused.textarea, .is-light.is-focused.input, .is-light.textarea:active, .is-light.input:active, .is-light.is-active.textarea, .is-light.is-active.input {\n box-shadow: 0 0 0 0.125em rgba(245, 245, 245, 0.25); }\n .is-dark.textarea, .is-dark.input {\n border-color: #363636; }\n .is-dark.textarea:focus, .is-dark.input:focus, .is-dark.is-focused.textarea, .is-dark.is-focused.input, .is-dark.textarea:active, .is-dark.input:active, .is-dark.is-active.textarea, .is-dark.is-active.input {\n box-shadow: 0 0 0 0.125em rgba(54, 54, 54, 0.25); }\n .is-primary.textarea, .is-primary.input {\n border-color: #ff0d68; }\n .is-primary.textarea:focus, .is-primary.input:focus, .is-primary.is-focused.textarea, .is-primary.is-focused.input, .is-primary.textarea:active, .is-primary.input:active, .is-primary.is-active.textarea, .is-primary.is-active.input {\n box-shadow: 0 0 0 0.125em rgba(255, 13, 104, 0.25); }\n .is-link.textarea, .is-link.input {\n border-color: #ff0d68; }\n .is-link.textarea:focus, .is-link.input:focus, .is-link.is-focused.textarea, .is-link.is-focused.input, .is-link.textarea:active, .is-link.input:active, .is-link.is-active.textarea, .is-link.is-active.input {\n box-shadow: 0 0 0 0.125em rgba(255, 13, 104, 0.25); }\n .is-info.textarea, .is-info.input {\n border-color: #0092FF; }\n .is-info.textarea:focus, .is-info.input:focus, .is-info.is-focused.textarea, .is-info.is-focused.input, .is-info.textarea:active, .is-info.input:active, .is-info.is-active.textarea, .is-info.is-active.input {\n box-shadow: 0 0 0 0.125em rgba(0, 146, 255, 0.25); }\n .is-success.textarea, .is-success.input {\n border-color: #16DB93; }\n .is-success.textarea:focus, .is-success.input:focus, .is-success.is-focused.textarea, .is-success.is-focused.input, .is-success.textarea:active, .is-success.input:active, .is-success.is-active.textarea, .is-success.is-active.input {\n box-shadow: 0 0 0 0.125em rgba(22, 219, 147, 0.25); }\n .is-warning.textarea, .is-warning.input {\n border-color: #FFE900; }\n .is-warning.textarea:focus, .is-warning.input:focus, .is-warning.is-focused.textarea, .is-warning.is-focused.input, .is-warning.textarea:active, .is-warning.input:active, .is-warning.is-active.textarea, .is-warning.is-active.input {\n box-shadow: 0 0 0 0.125em rgba(255, 233, 0, 0.25); }\n .is-danger.textarea, .is-danger.input {\n border-color: #f14668; }\n .is-danger.textarea:focus, .is-danger.input:focus, .is-danger.is-focused.textarea, .is-danger.is-focused.input, .is-danger.textarea:active, .is-danger.input:active, .is-danger.is-active.textarea, .is-danger.is-active.input {\n box-shadow: 0 0 0 0.125em rgba(241, 70, 104, 0.25); }\n .is-small.textarea, .is-small.input {\n border-radius: 2px;\n font-size: 0.75rem; }\n .is-medium.textarea, .is-medium.input {\n font-size: 1.25rem; }\n .is-large.textarea, .is-large.input {\n font-size: 1.5rem; }\n .is-fullwidth.textarea, .is-fullwidth.input {\n display: block;\n width: 100%; }\n .is-inline.textarea, .is-inline.input {\n display: inline;\n width: auto; }\n\n.input.is-rounded {\n border-radius: 9999px;\n padding-left: calc(calc(0.75em - 1px) + 0.375em);\n padding-right: calc(calc(0.75em - 1px) + 0.375em); }\n\n.input.is-static {\n background-color: transparent;\n border-color: transparent;\n box-shadow: none;\n padding-left: 0;\n padding-right: 0; }\n\n.textarea {\n display: block;\n max-width: 100%;\n min-width: 100%;\n padding: calc(0.75em - 1px);\n resize: vertical; }\n .textarea:not([rows]) {\n max-height: 40em;\n min-height: 8em; }\n .textarea[rows] {\n height: initial; }\n .textarea.has-fixed-size {\n resize: none; }\n\n.radio, .checkbox {\n cursor: pointer;\n display: inline-block;\n line-height: 1.25;\n position: relative; }\n .radio input, .checkbox input {\n cursor: pointer; }\n .radio:hover, .checkbox:hover {\n color: #363636; }\n [disabled].radio, [disabled].checkbox, fieldset[disabled] .radio, fieldset[disabled] .checkbox,\n .radio input[disabled],\n .checkbox input[disabled] {\n color: #7a7a7a;\n cursor: not-allowed; }\n\n.radio + .radio {\n margin-left: 0.5em; }\n\n.select {\n display: inline-block;\n max-width: 100%;\n position: relative;\n vertical-align: top; }\n .select:not(.is-multiple) {\n height: 2.5em; }\n .select:not(.is-multiple):not(.is-loading)::after {\n border-color: #ff0d68;\n right: 1.125em;\n z-index: 4; }\n .select.is-rounded select {\n border-radius: 9999px;\n padding-left: 1em; }\n .select select {\n cursor: pointer;\n display: block;\n font-size: 1em;\n max-width: 100%;\n outline: none; }\n .select select::-ms-expand {\n display: none; }\n .select select[disabled]:hover, fieldset[disabled] .select select:hover {\n border-color: whitesmoke; }\n .select select:not([multiple]) {\n padding-right: 2.5em; }\n .select select[multiple] {\n height: auto;\n padding: 0; }\n .select select[multiple] option {\n padding: 0.5em 1em; }\n .select:not(.is-multiple):not(.is-loading):hover::after {\n border-color: #363636; }\n .select.is-white:not(:hover)::after {\n border-color: white; }\n .select.is-white select {\n border-color: white; }\n .select.is-white select:hover, .select.is-white select.is-hovered {\n border-color: #f2f2f2; }\n .select.is-white select:focus, .select.is-white select.is-focused, .select.is-white select:active, .select.is-white select.is-active {\n box-shadow: 0 0 0 0.125em rgba(255, 255, 255, 0.25); }\n .select.is-black:not(:hover)::after {\n border-color: #0a0a0a; }\n .select.is-black select {\n border-color: #0a0a0a; }\n .select.is-black select:hover, .select.is-black select.is-hovered {\n border-color: black; }\n .select.is-black select:focus, .select.is-black select.is-focused, .select.is-black select:active, .select.is-black select.is-active {\n box-shadow: 0 0 0 0.125em rgba(10, 10, 10, 0.25); }\n .select.is-light:not(:hover)::after {\n border-color: whitesmoke; }\n .select.is-light select {\n border-color: whitesmoke; }\n .select.is-light select:hover, .select.is-light select.is-hovered {\n border-color: #e8e8e8; }\n .select.is-light select:focus, .select.is-light select.is-focused, .select.is-light select:active, .select.is-light select.is-active {\n box-shadow: 0 0 0 0.125em rgba(245, 245, 245, 0.25); }\n .select.is-dark:not(:hover)::after {\n border-color: #363636; }\n .select.is-dark select {\n border-color: #363636; }\n .select.is-dark select:hover, .select.is-dark select.is-hovered {\n border-color: #292929; }\n .select.is-dark select:focus, .select.is-dark select.is-focused, .select.is-dark select:active, .select.is-dark select.is-active {\n box-shadow: 0 0 0 0.125em rgba(54, 54, 54, 0.25); }\n .select.is-primary:not(:hover)::after {\n border-color: #ff0d68; }\n .select.is-primary select {\n border-color: #ff0d68; }\n .select.is-primary select:hover, .select.is-primary select.is-hovered {\n border-color: #f3005b; }\n .select.is-primary select:focus, .select.is-primary select.is-focused, .select.is-primary select:active, .select.is-primary select.is-active {\n box-shadow: 0 0 0 0.125em rgba(255, 13, 104, 0.25); }\n .select.is-link:not(:hover)::after {\n border-color: #ff0d68; }\n .select.is-link select {\n border-color: #ff0d68; }\n .select.is-link select:hover, .select.is-link select.is-hovered {\n border-color: #f3005b; }\n .select.is-link select:focus, .select.is-link select.is-focused, .select.is-link select:active, .select.is-link select.is-active {\n box-shadow: 0 0 0 0.125em rgba(255, 13, 104, 0.25); }\n .select.is-info:not(:hover)::after {\n border-color: #0092FF; }\n .select.is-info select {\n border-color: #0092FF; }\n .select.is-info select:hover, .select.is-info select.is-hovered {\n border-color: #0083e6; }\n .select.is-info select:focus, .select.is-info select.is-focused, .select.is-info select:active, .select.is-info select.is-active {\n box-shadow: 0 0 0 0.125em rgba(0, 146, 255, 0.25); }\n .select.is-success:not(:hover)::after {\n border-color: #16DB93; }\n .select.is-success select {\n border-color: #16DB93; }\n .select.is-success select:hover, .select.is-success select.is-hovered {\n border-color: #14c483; }\n .select.is-success select:focus, .select.is-success select.is-focused, .select.is-success select:active, .select.is-success select.is-active {\n box-shadow: 0 0 0 0.125em rgba(22, 219, 147, 0.25); }\n .select.is-warning:not(:hover)::after {\n border-color: #FFE900; }\n .select.is-warning select {\n border-color: #FFE900; }\n .select.is-warning select:hover, .select.is-warning select.is-hovered {\n border-color: #e6d200; }\n .select.is-warning select:focus, .select.is-warning select.is-focused, .select.is-warning select:active, .select.is-warning select.is-active {\n box-shadow: 0 0 0 0.125em rgba(255, 233, 0, 0.25); }\n .select.is-danger:not(:hover)::after {\n border-color: #f14668; }\n .select.is-danger select {\n border-color: #f14668; }\n .select.is-danger select:hover, .select.is-danger select.is-hovered {\n border-color: #ef2e55; }\n .select.is-danger select:focus, .select.is-danger select.is-focused, .select.is-danger select:active, .select.is-danger select.is-active {\n box-shadow: 0 0 0 0.125em rgba(241, 70, 104, 0.25); }\n .select.is-small {\n border-radius: 2px;\n font-size: 0.75rem; }\n .select.is-medium {\n font-size: 1.25rem; }\n .select.is-large {\n font-size: 1.5rem; }\n .select.is-disabled::after {\n border-color: #7a7a7a !important;\n opacity: 0.5; }\n .select.is-fullwidth {\n width: 100%; }\n .select.is-fullwidth select {\n width: 100%; }\n .select.is-loading::after {\n margin-top: 0;\n position: absolute;\n right: 0.625em;\n top: 0.625em;\n transform: none; }\n .select.is-loading.is-small:after {\n font-size: 0.75rem; }\n .select.is-loading.is-medium:after {\n font-size: 1.25rem; }\n .select.is-loading.is-large:after {\n font-size: 1.5rem; }\n\n.file {\n align-items: stretch;\n display: flex;\n justify-content: flex-start;\n position: relative; }\n .file.is-white .file-cta {\n background-color: white;\n border-color: transparent;\n color: #0a0a0a; }\n .file.is-white:hover .file-cta, .file.is-white.is-hovered .file-cta {\n background-color: #f9f9f9;\n border-color: transparent;\n color: #0a0a0a; }\n .file.is-white:focus .file-cta, .file.is-white.is-focused .file-cta {\n border-color: transparent;\n box-shadow: 0 0 0.5em rgba(255, 255, 255, 0.25);\n color: #0a0a0a; }\n .file.is-white:active .file-cta, .file.is-white.is-active .file-cta {\n background-color: #f2f2f2;\n border-color: transparent;\n color: #0a0a0a; }\n .file.is-black .file-cta {\n background-color: #0a0a0a;\n border-color: transparent;\n color: white; }\n .file.is-black:hover .file-cta, .file.is-black.is-hovered .file-cta {\n background-color: #040404;\n border-color: transparent;\n color: white; }\n .file.is-black:focus .file-cta, .file.is-black.is-focused .file-cta {\n border-color: transparent;\n box-shadow: 0 0 0.5em rgba(10, 10, 10, 0.25);\n color: white; }\n .file.is-black:active .file-cta, .file.is-black.is-active .file-cta {\n background-color: black;\n border-color: transparent;\n color: white; }\n .file.is-light .file-cta {\n background-color: whitesmoke;\n border-color: transparent;\n color: rgba(0, 0, 0, 0.7); }\n .file.is-light:hover .file-cta, .file.is-light.is-hovered .file-cta {\n background-color: #eeeeee;\n border-color: transparent;\n color: rgba(0, 0, 0, 0.7); }\n .file.is-light:focus .file-cta, .file.is-light.is-focused .file-cta {\n border-color: transparent;\n box-shadow: 0 0 0.5em rgba(245, 245, 245, 0.25);\n color: rgba(0, 0, 0, 0.7); }\n .file.is-light:active .file-cta, .file.is-light.is-active .file-cta {\n background-color: #e8e8e8;\n border-color: transparent;\n color: rgba(0, 0, 0, 0.7); }\n .file.is-dark .file-cta {\n background-color: #363636;\n border-color: transparent;\n color: #fff; }\n .file.is-dark:hover .file-cta, .file.is-dark.is-hovered .file-cta {\n background-color: #2f2f2f;\n border-color: transparent;\n color: #fff; }\n .file.is-dark:focus .file-cta, .file.is-dark.is-focused .file-cta {\n border-color: transparent;\n box-shadow: 0 0 0.5em rgba(54, 54, 54, 0.25);\n color: #fff; }\n .file.is-dark:active .file-cta, .file.is-dark.is-active .file-cta {\n background-color: #292929;\n border-color: transparent;\n color: #fff; }\n .file.is-primary .file-cta {\n background-color: #ff0d68;\n border-color: transparent;\n color: #fff; }\n .file.is-primary:hover .file-cta, .file.is-primary.is-hovered .file-cta {\n background-color: #ff0060;\n border-color: transparent;\n color: #fff; }\n .file.is-primary:focus .file-cta, .file.is-primary.is-focused .file-cta {\n border-color: transparent;\n box-shadow: 0 0 0.5em rgba(255, 13, 104, 0.25);\n color: #fff; }\n .file.is-primary:active .file-cta, .file.is-primary.is-active .file-cta {\n background-color: #f3005b;\n border-color: transparent;\n color: #fff; }\n .file.is-link .file-cta {\n background-color: #ff0d68;\n border-color: transparent;\n color: #fff; }\n .file.is-link:hover .file-cta, .file.is-link.is-hovered .file-cta {\n background-color: #ff0060;\n border-color: transparent;\n color: #fff; }\n .file.is-link:focus .file-cta, .file.is-link.is-focused .file-cta {\n border-color: transparent;\n box-shadow: 0 0 0.5em rgba(255, 13, 104, 0.25);\n color: #fff; }\n .file.is-link:active .file-cta, .file.is-link.is-active .file-cta {\n background-color: #f3005b;\n border-color: transparent;\n color: #fff; }\n .file.is-info .file-cta {\n background-color: #0092FF;\n border-color: transparent;\n color: #fff; }\n .file.is-info:hover .file-cta, .file.is-info.is-hovered .file-cta {\n background-color: #008bf2;\n border-color: transparent;\n color: #fff; }\n .file.is-info:focus .file-cta, .file.is-info.is-focused .file-cta {\n border-color: transparent;\n box-shadow: 0 0 0.5em rgba(0, 146, 255, 0.25);\n color: #fff; }\n .file.is-info:active .file-cta, .file.is-info.is-active .file-cta {\n background-color: #0083e6;\n border-color: transparent;\n color: #fff; }\n .file.is-success .file-cta {\n background-color: #16DB93;\n border-color: transparent;\n color: rgba(0, 0, 0, 0.7); }\n .file.is-success:hover .file-cta, .file.is-success.is-hovered .file-cta {\n background-color: #15cf8b;\n border-color: transparent;\n color: rgba(0, 0, 0, 0.7); }\n .file.is-success:focus .file-cta, .file.is-success.is-focused .file-cta {\n border-color: transparent;\n box-shadow: 0 0 0.5em rgba(22, 219, 147, 0.25);\n color: rgba(0, 0, 0, 0.7); }\n .file.is-success:active .file-cta, .file.is-success.is-active .file-cta {\n background-color: #14c483;\n border-color: transparent;\n color: rgba(0, 0, 0, 0.7); }\n .file.is-warning .file-cta {\n background-color: #FFE900;\n border-color: transparent;\n color: rgba(0, 0, 0, 0.7); }\n .file.is-warning:hover .file-cta, .file.is-warning.is-hovered .file-cta {\n background-color: #f2dd00;\n border-color: transparent;\n color: rgba(0, 0, 0, 0.7); }\n .file.is-warning:focus .file-cta, .file.is-warning.is-focused .file-cta {\n border-color: transparent;\n box-shadow: 0 0 0.5em rgba(255, 233, 0, 0.25);\n color: rgba(0, 0, 0, 0.7); }\n .file.is-warning:active .file-cta, .file.is-warning.is-active .file-cta {\n background-color: #e6d200;\n border-color: transparent;\n color: rgba(0, 0, 0, 0.7); }\n .file.is-danger .file-cta {\n background-color: #f14668;\n border-color: transparent;\n color: #fff; }\n .file.is-danger:hover .file-cta, .file.is-danger.is-hovered .file-cta {\n background-color: #f03a5f;\n border-color: transparent;\n color: #fff; }\n .file.is-danger:focus .file-cta, .file.is-danger.is-focused .file-cta {\n border-color: transparent;\n box-shadow: 0 0 0.5em rgba(241, 70, 104, 0.25);\n color: #fff; }\n .file.is-danger:active .file-cta, .file.is-danger.is-active .file-cta {\n background-color: #ef2e55;\n border-color: transparent;\n color: #fff; }\n .file.is-small {\n font-size: 0.75rem; }\n .file.is-normal {\n font-size: 1rem; }\n .file.is-medium {\n font-size: 1.25rem; }\n .file.is-medium .file-icon .fa {\n font-size: 21px; }\n .file.is-large {\n font-size: 1.5rem; }\n .file.is-large .file-icon .fa {\n font-size: 28px; }\n .file.has-name .file-cta {\n border-bottom-right-radius: 0;\n border-top-right-radius: 0; }\n .file.has-name .file-name {\n border-bottom-left-radius: 0;\n border-top-left-radius: 0; }\n .file.has-name.is-empty .file-cta {\n border-radius: 4px; }\n .file.has-name.is-empty .file-name {\n display: none; }\n .file.is-boxed .file-label {\n flex-direction: column; }\n .file.is-boxed .file-cta {\n flex-direction: column;\n height: auto;\n padding: 1em 3em; }\n .file.is-boxed .file-name {\n border-width: 0 1px 1px; }\n .file.is-boxed .file-icon {\n height: 1.5em;\n width: 1.5em; }\n .file.is-boxed .file-icon .fa {\n font-size: 21px; }\n .file.is-boxed.is-small .file-icon .fa {\n font-size: 14px; }\n .file.is-boxed.is-medium .file-icon .fa {\n font-size: 28px; }\n .file.is-boxed.is-large .file-icon .fa {\n font-size: 35px; }\n .file.is-boxed.has-name .file-cta {\n border-radius: 4px 4px 0 0; }\n .file.is-boxed.has-name .file-name {\n border-radius: 0 0 4px 4px;\n border-width: 0 1px 1px; }\n .file.is-centered {\n justify-content: center; }\n .file.is-fullwidth .file-label {\n width: 100%; }\n .file.is-fullwidth .file-name {\n flex-grow: 1;\n max-width: none; }\n .file.is-right {\n justify-content: flex-end; }\n .file.is-right .file-cta {\n border-radius: 0 4px 4px 0; }\n .file.is-right .file-name {\n border-radius: 4px 0 0 4px;\n border-width: 1px 0 1px 1px;\n order: -1; }\n\n.file-label {\n align-items: stretch;\n display: flex;\n cursor: pointer;\n justify-content: flex-start;\n overflow: hidden;\n position: relative; }\n .file-label:hover .file-cta {\n background-color: #eeeeee;\n color: #363636; }\n .file-label:hover .file-name {\n border-color: #d5d5d5; }\n .file-label:active .file-cta {\n background-color: #e8e8e8;\n color: #363636; }\n .file-label:active .file-name {\n border-color: #cfcfcf; }\n\n.file-input {\n height: 100%;\n left: 0;\n opacity: 0;\n outline: none;\n position: absolute;\n top: 0;\n width: 100%; }\n\n.file-cta,\n.file-name {\n border-color: #dbdbdb;\n border-radius: 4px;\n font-size: 1em;\n padding-left: 1em;\n padding-right: 1em;\n white-space: nowrap; }\n\n.file-cta {\n background-color: whitesmoke;\n color: #4a4a4a; }\n\n.file-name {\n border-color: #dbdbdb;\n border-style: solid;\n border-width: 1px 1px 1px 0;\n display: block;\n max-width: 16em;\n overflow: hidden;\n text-align: inherit;\n text-overflow: ellipsis; }\n\n.file-icon {\n align-items: center;\n display: flex;\n height: 1em;\n justify-content: center;\n margin-right: 0.5em;\n width: 1em; }\n .file-icon .fa {\n font-size: 14px; }\n\n.label {\n color: #363636;\n display: block;\n font-size: 1rem;\n font-weight: 700; }\n .label:not(:last-child) {\n margin-bottom: 0.5em; }\n .label.is-small {\n font-size: 0.75rem; }\n .label.is-medium {\n font-size: 1.25rem; }\n .label.is-large {\n font-size: 1.5rem; }\n\n.help {\n display: block;\n font-size: 0.75rem;\n margin-top: 0.25rem; }\n .help.is-white {\n color: white; }\n .help.is-black {\n color: #0a0a0a; }\n .help.is-light {\n color: whitesmoke; }\n .help.is-dark {\n color: #363636; }\n .help.is-primary {\n color: #ff0d68; }\n .help.is-link {\n color: #ff0d68; }\n .help.is-info {\n color: #0092FF; }\n .help.is-success {\n color: #16DB93; }\n .help.is-warning {\n color: #FFE900; }\n .help.is-danger {\n color: #f14668; }\n\n.field:not(:last-child) {\n margin-bottom: 0.75rem; }\n\n.field.has-addons {\n display: flex;\n justify-content: flex-start; }\n .field.has-addons .control:not(:last-child) {\n margin-right: -1px; }\n .field.has-addons .control:not(:first-child):not(:last-child) .button,\n .field.has-addons .control:not(:first-child):not(:last-child) .input,\n .field.has-addons .control:not(:first-child):not(:last-child) .select select {\n border-radius: 0; }\n .field.has-addons .control:first-child:not(:only-child) .button,\n .field.has-addons .control:first-child:not(:only-child) .input,\n .field.has-addons .control:first-child:not(:only-child) .select select {\n border-bottom-right-radius: 0;\n border-top-right-radius: 0; }\n .field.has-addons .control:last-child:not(:only-child) .button,\n .field.has-addons .control:last-child:not(:only-child) .input,\n .field.has-addons .control:last-child:not(:only-child) .select select {\n border-bottom-left-radius: 0;\n border-top-left-radius: 0; }\n .field.has-addons .control .button:not([disabled]):hover, .field.has-addons .control .button:not([disabled]).is-hovered,\n .field.has-addons .control .input:not([disabled]):hover,\n .field.has-addons .control .input:not([disabled]).is-hovered,\n .field.has-addons .control .select select:not([disabled]):hover,\n .field.has-addons .control .select select:not([disabled]).is-hovered {\n z-index: 2; }\n .field.has-addons .control .button:not([disabled]):focus, .field.has-addons .control .button:not([disabled]).is-focused, .field.has-addons .control .button:not([disabled]):active, .field.has-addons .control .button:not([disabled]).is-active,\n .field.has-addons .control .input:not([disabled]):focus,\n .field.has-addons .control .input:not([disabled]).is-focused,\n .field.has-addons .control .input:not([disabled]):active,\n .field.has-addons .control .input:not([disabled]).is-active,\n .field.has-addons .control .select select:not([disabled]):focus,\n .field.has-addons .control .select select:not([disabled]).is-focused,\n .field.has-addons .control .select select:not([disabled]):active,\n .field.has-addons .control .select select:not([disabled]).is-active {\n z-index: 3; }\n .field.has-addons .control .button:not([disabled]):focus:hover, .field.has-addons .control .button:not([disabled]).is-focused:hover, .field.has-addons .control .button:not([disabled]):active:hover, .field.has-addons .control .button:not([disabled]).is-active:hover,\n .field.has-addons .control .input:not([disabled]):focus:hover,\n .field.has-addons .control .input:not([disabled]).is-focused:hover,\n .field.has-addons .control .input:not([disabled]):active:hover,\n .field.has-addons .control .input:not([disabled]).is-active:hover,\n .field.has-addons .control .select select:not([disabled]):focus:hover,\n .field.has-addons .control .select select:not([disabled]).is-focused:hover,\n .field.has-addons .control .select select:not([disabled]):active:hover,\n .field.has-addons .control .select select:not([disabled]).is-active:hover {\n z-index: 4; }\n .field.has-addons .control.is-expanded {\n flex-grow: 1;\n flex-shrink: 1; }\n .field.has-addons.has-addons-centered {\n justify-content: center; }\n .field.has-addons.has-addons-right {\n justify-content: flex-end; }\n .field.has-addons.has-addons-fullwidth .control {\n flex-grow: 1;\n flex-shrink: 0; }\n\n.field.is-grouped {\n display: flex;\n justify-content: flex-start; }\n .field.is-grouped > .control {\n flex-shrink: 0; }\n .field.is-grouped > .control:not(:last-child) {\n margin-bottom: 0;\n margin-right: 0.75rem; }\n .field.is-grouped > .control.is-expanded {\n flex-grow: 1;\n flex-shrink: 1; }\n .field.is-grouped.is-grouped-centered {\n justify-content: center; }\n .field.is-grouped.is-grouped-right {\n justify-content: flex-end; }\n .field.is-grouped.is-grouped-multiline {\n flex-wrap: wrap; }\n .field.is-grouped.is-grouped-multiline > .control:last-child, .field.is-grouped.is-grouped-multiline > .control:not(:last-child) {\n margin-bottom: 0.75rem; }\n .field.is-grouped.is-grouped-multiline:last-child {\n margin-bottom: -0.75rem; }\n .field.is-grouped.is-grouped-multiline:not(:last-child) {\n margin-bottom: 0; }\n\n@media screen and (min-width: 769px), print {\n .field.is-horizontal {\n display: flex; } }\n\n.field-label .label {\n font-size: inherit; }\n\n@media screen and (max-width: 768px) {\n .field-label {\n margin-bottom: 0.5rem; } }\n\n@media screen and (min-width: 769px), print {\n .field-label {\n flex-basis: 0;\n flex-grow: 1;\n flex-shrink: 0;\n margin-right: 1.5rem;\n text-align: right; }\n .field-label.is-small {\n font-size: 0.75rem;\n padding-top: 0.375em; }\n .field-label.is-normal {\n padding-top: 0.375em; }\n .field-label.is-medium {\n font-size: 1.25rem;\n padding-top: 0.375em; }\n .field-label.is-large {\n font-size: 1.5rem;\n padding-top: 0.375em; } }\n\n.field-body .field .field {\n margin-bottom: 0; }\n\n@media screen and (min-width: 769px), print {\n .field-body {\n display: flex;\n flex-basis: 0;\n flex-grow: 5;\n flex-shrink: 1; }\n .field-body .field {\n margin-bottom: 0; }\n .field-body > .field {\n flex-shrink: 1; }\n .field-body > .field:not(.is-narrow) {\n flex-grow: 1; }\n .field-body > .field:not(:last-child) {\n margin-right: 0.75rem; } }\n\n.control {\n box-sizing: border-box;\n clear: both;\n font-size: 1rem;\n position: relative;\n text-align: inherit; }\n .control.has-icons-left .input:focus ~ .icon,\n .control.has-icons-left .select:focus ~ .icon, .control.has-icons-right .input:focus ~ .icon,\n .control.has-icons-right .select:focus ~ .icon {\n color: #4a4a4a; }\n .control.has-icons-left .input.is-small ~ .icon,\n .control.has-icons-left .select.is-small ~ .icon, .control.has-icons-right .input.is-small ~ .icon,\n .control.has-icons-right .select.is-small ~ .icon {\n font-size: 0.75rem; }\n .control.has-icons-left .input.is-medium ~ .icon,\n .control.has-icons-left .select.is-medium ~ .icon, .control.has-icons-right .input.is-medium ~ .icon,\n .control.has-icons-right .select.is-medium ~ .icon {\n font-size: 1.25rem; }\n .control.has-icons-left .input.is-large ~ .icon,\n .control.has-icons-left .select.is-large ~ .icon, .control.has-icons-right .input.is-large ~ .icon,\n .control.has-icons-right .select.is-large ~ .icon {\n font-size: 1.5rem; }\n .control.has-icons-left .icon, .control.has-icons-right .icon {\n color: #dbdbdb;\n height: 2.5em;\n pointer-events: none;\n position: absolute;\n top: 0;\n width: 2.5em;\n z-index: 4; }\n .control.has-icons-left .input,\n .control.has-icons-left .select select {\n padding-left: 2.5em; }\n .control.has-icons-left .icon.is-left {\n left: 0; }\n .control.has-icons-right .input,\n .control.has-icons-right .select select {\n padding-right: 2.5em; }\n .control.has-icons-right .icon.is-right {\n right: 0; }\n .control.is-loading::after {\n position: absolute !important;\n right: 0.625em;\n top: 0.625em;\n z-index: 4; }\n .control.is-loading.is-small:after {\n font-size: 0.75rem; }\n .control.is-loading.is-medium:after {\n font-size: 1.25rem; }\n .control.is-loading.is-large:after {\n font-size: 1.5rem; }\n\n/* Bulma Components */\n.breadcrumb {\n font-size: 1rem;\n white-space: nowrap; }\n .breadcrumb a {\n align-items: center;\n color: #ff0d68;\n display: flex;\n justify-content: center;\n padding: 0 0.75em; }\n .breadcrumb a:hover {\n color: #363636; }\n .breadcrumb li {\n align-items: center;\n display: flex; }\n .breadcrumb li:first-child a {\n padding-left: 0; }\n .breadcrumb li.is-active a {\n color: #363636;\n cursor: default;\n pointer-events: none; }\n .breadcrumb li + li::before {\n color: #b5b5b5;\n content: \"\\0002f\"; }\n .breadcrumb ul,\n .breadcrumb ol {\n align-items: flex-start;\n display: flex;\n flex-wrap: wrap;\n justify-content: flex-start; }\n .breadcrumb .icon:first-child {\n margin-right: 0.5em; }\n .breadcrumb .icon:last-child {\n margin-left: 0.5em; }\n .breadcrumb.is-centered ol,\n .breadcrumb.is-centered ul {\n justify-content: center; }\n .breadcrumb.is-right ol,\n .breadcrumb.is-right ul {\n justify-content: flex-end; }\n .breadcrumb.is-small {\n font-size: 0.75rem; }\n .breadcrumb.is-medium {\n font-size: 1.25rem; }\n .breadcrumb.is-large {\n font-size: 1.5rem; }\n .breadcrumb.has-arrow-separator li + li::before {\n content: \"\\02192\"; }\n .breadcrumb.has-bullet-separator li + li::before {\n content: \"\\02022\"; }\n .breadcrumb.has-dot-separator li + li::before {\n content: \"\\000b7\"; }\n .breadcrumb.has-succeeds-separator li + li::before {\n content: \"\\0227B\"; }\n\n.card {\n background-color: white;\n border-radius: 0.25rem;\n box-shadow: 0 0.5em 1em -0.125em rgba(10, 10, 10, 0.1), 0 0px 0 1px rgba(10, 10, 10, 0.02);\n color: #4a4a4a;\n max-width: 100%;\n position: relative; }\n\n.card-footer:first-child, .card-content:first-child, .card-header:first-child {\n border-top-left-radius: 0.25rem;\n border-top-right-radius: 0.25rem; }\n\n.card-footer:last-child, .card-content:last-child, .card-header:last-child {\n border-bottom-left-radius: 0.25rem;\n border-bottom-right-radius: 0.25rem; }\n\n.card-header {\n background-color: transparent;\n align-items: stretch;\n box-shadow: 0 0.125em 0.25em rgba(10, 10, 10, 0.1);\n display: flex; }\n\n.card-header-title {\n align-items: center;\n color: #363636;\n display: flex;\n flex-grow: 1;\n font-weight: 700;\n padding: 0.75rem 1rem; }\n .card-header-title.is-centered {\n justify-content: center; }\n\n.card-header-icon {\n -moz-appearance: none;\n -webkit-appearance: none;\n appearance: none;\n background: none;\n border: none;\n color: currentColor;\n font-family: inherit;\n font-size: 1em;\n margin: 0;\n padding: 0;\n align-items: center;\n cursor: pointer;\n display: flex;\n justify-content: center;\n padding: 0.75rem 1rem; }\n\n.card-image {\n display: block;\n position: relative; }\n .card-image:first-child img {\n border-top-left-radius: 0.25rem;\n border-top-right-radius: 0.25rem; }\n .card-image:last-child img {\n border-bottom-left-radius: 0.25rem;\n border-bottom-right-radius: 0.25rem; }\n\n.card-content {\n background-color: transparent;\n padding: 1.5rem; }\n\n.card-footer {\n background-color: transparent;\n border-top: 1px solid #ededed;\n align-items: stretch;\n display: flex; }\n\n.card-footer-item {\n align-items: center;\n display: flex;\n flex-basis: 0;\n flex-grow: 1;\n flex-shrink: 0;\n justify-content: center;\n padding: 0.75rem; }\n .card-footer-item:not(:last-child) {\n border-right: 1px solid #ededed; }\n\n.card .media:not(:last-child) {\n margin-bottom: 1.5rem; }\n\n.dropdown {\n display: inline-flex;\n position: relative;\n vertical-align: top; }\n .dropdown.is-active .dropdown-menu, .dropdown.is-hoverable:hover .dropdown-menu {\n display: block; }\n .dropdown.is-right .dropdown-menu {\n left: auto;\n right: 0; }\n .dropdown.is-up .dropdown-menu {\n bottom: 100%;\n padding-bottom: 4px;\n padding-top: initial;\n top: auto; }\n\n.dropdown-menu {\n display: none;\n left: 0;\n min-width: 12rem;\n padding-top: 4px;\n position: absolute;\n top: 100%;\n z-index: 20; }\n\n.dropdown-content {\n background-color: white;\n border-radius: 4px;\n box-shadow: 0 0.5em 1em -0.125em rgba(10, 10, 10, 0.1), 0 0px 0 1px rgba(10, 10, 10, 0.02);\n padding-bottom: 0.5rem;\n padding-top: 0.5rem; }\n\n.dropdown-item {\n color: #4a4a4a;\n display: block;\n font-size: 0.875rem;\n line-height: 1.5;\n padding: 0.375rem 1rem;\n position: relative; }\n\na.dropdown-item,\nbutton.dropdown-item {\n padding-right: 3rem;\n text-align: inherit;\n white-space: nowrap;\n width: 100%; }\n a.dropdown-item:hover,\n button.dropdown-item:hover {\n background-color: whitesmoke;\n color: #0a0a0a; }\n a.dropdown-item.is-active,\n button.dropdown-item.is-active {\n background-color: #ff0d68;\n color: #fff; }\n\n.dropdown-divider {\n background-color: #ededed;\n border: none;\n display: block;\n height: 1px;\n margin: 0.5rem 0; }\n\n.level {\n align-items: center;\n justify-content: space-between; }\n .level code {\n border-radius: 4px; }\n .level img {\n display: inline-block;\n vertical-align: top; }\n .level.is-mobile {\n display: flex; }\n .level.is-mobile .level-left,\n .level.is-mobile .level-right {\n display: flex; }\n .level.is-mobile .level-left + .level-right {\n margin-top: 0; }\n .level.is-mobile .level-item:not(:last-child) {\n margin-bottom: 0;\n margin-right: 0.75rem; }\n .level.is-mobile .level-item:not(.is-narrow) {\n flex-grow: 1; }\n @media screen and (min-width: 769px), print {\n .level {\n display: flex; }\n .level > .level-item:not(.is-narrow) {\n flex-grow: 1; } }\n.level-item {\n align-items: center;\n display: flex;\n flex-basis: auto;\n flex-grow: 0;\n flex-shrink: 0;\n justify-content: center; }\n .level-item .title,\n .level-item .subtitle {\n margin-bottom: 0; }\n @media screen and (max-width: 768px) {\n .level-item:not(:last-child) {\n margin-bottom: 0.75rem; } }\n.level-left,\n.level-right {\n flex-basis: auto;\n flex-grow: 0;\n flex-shrink: 0; }\n .level-left .level-item.is-flexible,\n .level-right .level-item.is-flexible {\n flex-grow: 1; }\n @media screen and (min-width: 769px), print {\n .level-left .level-item:not(:last-child),\n .level-right .level-item:not(:last-child) {\n margin-right: 0.75rem; } }\n.level-left {\n align-items: center;\n justify-content: flex-start; }\n @media screen and (max-width: 768px) {\n .level-left + .level-right {\n margin-top: 1.5rem; } }\n @media screen and (min-width: 769px), print {\n .level-left {\n display: flex; } }\n.level-right {\n align-items: center;\n justify-content: flex-end; }\n @media screen and (min-width: 769px), print {\n .level-right {\n display: flex; } }\n.media {\n align-items: flex-start;\n display: flex;\n text-align: inherit; }\n .media .content:not(:last-child) {\n margin-bottom: 0.75rem; }\n .media .media {\n border-top: 1px solid rgba(219, 219, 219, 0.5);\n display: flex;\n padding-top: 0.75rem; }\n .media .media .content:not(:last-child),\n .media .media .control:not(:last-child) {\n margin-bottom: 0.5rem; }\n .media .media .media {\n padding-top: 0.5rem; }\n .media .media .media + .media {\n margin-top: 0.5rem; }\n .media + .media {\n border-top: 1px solid rgba(219, 219, 219, 0.5);\n margin-top: 1rem;\n padding-top: 1rem; }\n .media.is-large + .media {\n margin-top: 1.5rem;\n padding-top: 1.5rem; }\n\n.media-left,\n.media-right {\n flex-basis: auto;\n flex-grow: 0;\n flex-shrink: 0; }\n\n.media-left {\n margin-right: 1rem; }\n\n.media-right {\n margin-left: 1rem; }\n\n.media-content {\n flex-basis: auto;\n flex-grow: 1;\n flex-shrink: 1;\n text-align: inherit; }\n\n@media screen and (max-width: 768px) {\n .media-content {\n overflow-x: auto; } }\n\n.menu {\n font-size: 1rem; }\n .menu.is-small {\n font-size: 0.75rem; }\n .menu.is-medium {\n font-size: 1.25rem; }\n .menu.is-large {\n font-size: 1.5rem; }\n\n.menu-list {\n line-height: 1.25; }\n .menu-list a {\n border-radius: 2px;\n color: #4a4a4a;\n display: block;\n padding: 0.5em 0.75em; }\n .menu-list a:hover {\n background-color: whitesmoke;\n color: #363636; }\n .menu-list a.is-active {\n background-color: #ff0d68;\n color: #fff; }\n .menu-list li ul {\n border-left: 1px solid #dbdbdb;\n margin: 0.75em;\n padding-left: 0.75em; }\n\n.menu-label {\n color: #7a7a7a;\n font-size: 0.75em;\n letter-spacing: 0.1em;\n text-transform: uppercase; }\n .menu-label:not(:first-child) {\n margin-top: 1em; }\n .menu-label:not(:last-child) {\n margin-bottom: 1em; }\n\n.message {\n background-color: whitesmoke;\n border-radius: 4px;\n font-size: 1rem; }\n .message strong {\n color: currentColor; }\n .message a:not(.button):not(.tag):not(.dropdown-item) {\n color: currentColor;\n text-decoration: underline; }\n .message.is-small {\n font-size: 0.75rem; }\n .message.is-medium {\n font-size: 1.25rem; }\n .message.is-large {\n font-size: 1.5rem; }\n .message.is-white {\n background-color: white; }\n .message.is-white .message-header {\n background-color: white;\n color: #0a0a0a; }\n .message.is-white .message-body {\n border-color: white; }\n .message.is-black {\n background-color: #fafafa; }\n .message.is-black .message-header {\n background-color: #0a0a0a;\n color: white; }\n .message.is-black .message-body {\n border-color: #0a0a0a; }\n .message.is-light {\n background-color: #fafafa; }\n .message.is-light .message-header {\n background-color: whitesmoke;\n color: rgba(0, 0, 0, 0.7); }\n .message.is-light .message-body {\n border-color: whitesmoke; }\n .message.is-dark {\n background-color: #fafafa; }\n .message.is-dark .message-header {\n background-color: #363636;\n color: #fff; }\n .message.is-dark .message-body {\n border-color: #363636; }\n .message.is-primary {\n background-color: #ffebf2; }\n .message.is-primary .message-header {\n background-color: #ff0d68;\n color: #fff; }\n .message.is-primary .message-body {\n border-color: #ff0d68;\n color: #e60056; }\n .message.is-link {\n background-color: #ffebf2; }\n .message.is-link .message-header {\n background-color: #ff0d68;\n color: #fff; }\n .message.is-link .message-body {\n border-color: #ff0d68;\n color: #e60056; }\n .message.is-info {\n background-color: #ebf6ff; }\n .message.is-info .message-header {\n background-color: #0092FF;\n color: #fff; }\n .message.is-info .message-body {\n border-color: #0092FF;\n color: #0075cc; }\n .message.is-success {\n background-color: #ecfdf7; }\n .message.is-success .message-header {\n background-color: #16DB93;\n color: rgba(0, 0, 0, 0.7); }\n .message.is-success .message-body {\n border-color: #16DB93;\n color: #0e865a; }\n .message.is-warning {\n background-color: #fffdeb; }\n .message.is-warning .message-header {\n background-color: #FFE900;\n color: rgba(0, 0, 0, 0.7); }\n .message.is-warning .message-body {\n border-color: #FFE900;\n color: #948700; }\n .message.is-danger {\n background-color: #feecf0; }\n .message.is-danger .message-header {\n background-color: #f14668;\n color: #fff; }\n .message.is-danger .message-body {\n border-color: #f14668;\n color: #cc0f35; }\n\n.message-header {\n align-items: center;\n background-color: #4a4a4a;\n border-radius: 4px 4px 0 0;\n color: #fff;\n display: flex;\n font-weight: 700;\n justify-content: space-between;\n line-height: 1.25;\n padding: 0.75em 1em;\n position: relative; }\n .message-header .delete {\n flex-grow: 0;\n flex-shrink: 0;\n margin-left: 0.75em; }\n .message-header + .message-body {\n border-width: 0;\n border-top-left-radius: 0;\n border-top-right-radius: 0; }\n\n.message-body {\n border-color: #dbdbdb;\n border-radius: 4px;\n border-style: solid;\n border-width: 0 0 0 4px;\n color: #4a4a4a;\n padding: 1.25em 1.5em; }\n .message-body code,\n .message-body pre {\n background-color: white; }\n .message-body pre code {\n background-color: transparent; }\n\n.modal {\n align-items: center;\n display: none;\n flex-direction: column;\n justify-content: center;\n overflow: hidden;\n position: fixed;\n z-index: 40; }\n .modal.is-active {\n display: flex; }\n\n.modal-background {\n background-color: rgba(10, 10, 10, 0.86); }\n\n.modal-content,\n.modal-card {\n margin: 0 20px;\n max-height: calc(100vh - 160px);\n overflow: auto;\n position: relative;\n width: 100%; }\n @media screen and (min-width: 769px) {\n .modal-content,\n .modal-card {\n margin: 0 auto;\n max-height: calc(100vh - 40px);\n width: 640px; } }\n.modal-close {\n background: none;\n height: 40px;\n position: fixed;\n right: 20px;\n top: 20px;\n width: 40px; }\n\n.modal-card {\n display: flex;\n flex-direction: column;\n max-height: calc(100vh - 40px);\n overflow: hidden;\n -ms-overflow-y: visible; }\n\n.modal-card-head,\n.modal-card-foot {\n align-items: center;\n background-color: whitesmoke;\n display: flex;\n flex-shrink: 0;\n justify-content: flex-start;\n padding: 20px;\n position: relative; }\n\n.modal-card-head {\n border-bottom: 1px solid #dbdbdb;\n border-top-left-radius: 6px;\n border-top-right-radius: 6px; }\n\n.modal-card-title {\n color: #363636;\n flex-grow: 1;\n flex-shrink: 0;\n font-size: 1.5rem;\n line-height: 1; }\n\n.modal-card-foot {\n border-bottom-left-radius: 6px;\n border-bottom-right-radius: 6px;\n border-top: 1px solid #dbdbdb; }\n .modal-card-foot .button:not(:last-child) {\n margin-right: 0.5em; }\n\n.modal-card-body {\n -webkit-overflow-scrolling: touch;\n background-color: white;\n flex-grow: 1;\n flex-shrink: 1;\n overflow: auto;\n padding: 20px; }\n\n.navbar {\n background-color: white;\n min-height: 3.25rem;\n position: relative;\n z-index: 30; }\n .navbar.is-white {\n background-color: white;\n color: #0a0a0a; }\n .navbar.is-white .navbar-brand > .navbar-item,\n .navbar.is-white .navbar-brand .navbar-link {\n color: #0a0a0a; }\n .navbar.is-white .navbar-brand > a.navbar-item:focus, .navbar.is-white .navbar-brand > a.navbar-item:hover, .navbar.is-white .navbar-brand > a.navbar-item.is-active,\n .navbar.is-white .navbar-brand .navbar-link:focus,\n .navbar.is-white .navbar-brand .navbar-link:hover,\n .navbar.is-white .navbar-brand .navbar-link.is-active {\n background-color: #f2f2f2;\n color: #0a0a0a; }\n .navbar.is-white .navbar-brand .navbar-link::after {\n border-color: #0a0a0a; }\n .navbar.is-white .navbar-burger {\n color: #0a0a0a; }\n @media screen and (min-width: 1024px) {\n .navbar.is-white .navbar-start > .navbar-item,\n .navbar.is-white .navbar-start .navbar-link,\n .navbar.is-white .navbar-end > .navbar-item,\n .navbar.is-white .navbar-end .navbar-link {\n color: #0a0a0a; }\n .navbar.is-white .navbar-start > a.navbar-item:focus, .navbar.is-white .navbar-start > a.navbar-item:hover, .navbar.is-white .navbar-start > a.navbar-item.is-active,\n .navbar.is-white .navbar-start .navbar-link:focus,\n .navbar.is-white .navbar-start .navbar-link:hover,\n .navbar.is-white .navbar-start .navbar-link.is-active,\n .navbar.is-white .navbar-end > a.navbar-item:focus,\n .navbar.is-white .navbar-end > a.navbar-item:hover,\n .navbar.is-white .navbar-end > a.navbar-item.is-active,\n .navbar.is-white .navbar-end .navbar-link:focus,\n .navbar.is-white .navbar-end .navbar-link:hover,\n .navbar.is-white .navbar-end .navbar-link.is-active {\n background-color: #f2f2f2;\n color: #0a0a0a; }\n .navbar.is-white .navbar-start .navbar-link::after,\n .navbar.is-white .navbar-end .navbar-link::after {\n border-color: #0a0a0a; }\n .navbar.is-white .navbar-item.has-dropdown:focus .navbar-link,\n .navbar.is-white .navbar-item.has-dropdown:hover .navbar-link,\n .navbar.is-white .navbar-item.has-dropdown.is-active .navbar-link {\n background-color: #f2f2f2;\n color: #0a0a0a; }\n .navbar.is-white .navbar-dropdown a.navbar-item.is-active {\n background-color: white;\n color: #0a0a0a; } }\n .navbar.is-black {\n background-color: #0a0a0a;\n color: white; }\n .navbar.is-black .navbar-brand > .navbar-item,\n .navbar.is-black .navbar-brand .navbar-link {\n color: white; }\n .navbar.is-black .navbar-brand > a.navbar-item:focus, .navbar.is-black .navbar-brand > a.navbar-item:hover, .navbar.is-black .navbar-brand > a.navbar-item.is-active,\n .navbar.is-black .navbar-brand .navbar-link:focus,\n .navbar.is-black .navbar-brand .navbar-link:hover,\n .navbar.is-black .navbar-brand .navbar-link.is-active {\n background-color: black;\n color: white; }\n .navbar.is-black .navbar-brand .navbar-link::after {\n border-color: white; }\n .navbar.is-black .navbar-burger {\n color: white; }\n @media screen and (min-width: 1024px) {\n .navbar.is-black .navbar-start > .navbar-item,\n .navbar.is-black .navbar-start .navbar-link,\n .navbar.is-black .navbar-end > .navbar-item,\n .navbar.is-black .navbar-end .navbar-link {\n color: white; }\n .navbar.is-black .navbar-start > a.navbar-item:focus, .navbar.is-black .navbar-start > a.navbar-item:hover, .navbar.is-black .navbar-start > a.navbar-item.is-active,\n .navbar.is-black .navbar-start .navbar-link:focus,\n .navbar.is-black .navbar-start .navbar-link:hover,\n .navbar.is-black .navbar-start .navbar-link.is-active,\n .navbar.is-black .navbar-end > a.navbar-item:focus,\n .navbar.is-black .navbar-end > a.navbar-item:hover,\n .navbar.is-black .navbar-end > a.navbar-item.is-active,\n .navbar.is-black .navbar-end .navbar-link:focus,\n .navbar.is-black .navbar-end .navbar-link:hover,\n .navbar.is-black .navbar-end .navbar-link.is-active {\n background-color: black;\n color: white; }\n .navbar.is-black .navbar-start .navbar-link::after,\n .navbar.is-black .navbar-end .navbar-link::after {\n border-color: white; }\n .navbar.is-black .navbar-item.has-dropdown:focus .navbar-link,\n .navbar.is-black .navbar-item.has-dropdown:hover .navbar-link,\n .navbar.is-black .navbar-item.has-dropdown.is-active .navbar-link {\n background-color: black;\n color: white; }\n .navbar.is-black .navbar-dropdown a.navbar-item.is-active {\n background-color: #0a0a0a;\n color: white; } }\n .navbar.is-light {\n background-color: whitesmoke;\n color: rgba(0, 0, 0, 0.7); }\n .navbar.is-light .navbar-brand > .navbar-item,\n .navbar.is-light .navbar-brand .navbar-link {\n color: rgba(0, 0, 0, 0.7); }\n .navbar.is-light .navbar-brand > a.navbar-item:focus, .navbar.is-light .navbar-brand > a.navbar-item:hover, .navbar.is-light .navbar-brand > a.navbar-item.is-active,\n .navbar.is-light .navbar-brand .navbar-link:focus,\n .navbar.is-light .navbar-brand .navbar-link:hover,\n .navbar.is-light .navbar-brand .navbar-link.is-active {\n background-color: #e8e8e8;\n color: rgba(0, 0, 0, 0.7); }\n .navbar.is-light .navbar-brand .navbar-link::after {\n border-color: rgba(0, 0, 0, 0.7); }\n .navbar.is-light .navbar-burger {\n color: rgba(0, 0, 0, 0.7); }\n @media screen and (min-width: 1024px) {\n .navbar.is-light .navbar-start > .navbar-item,\n .navbar.is-light .navbar-start .navbar-link,\n .navbar.is-light .navbar-end > .navbar-item,\n .navbar.is-light .navbar-end .navbar-link {\n color: rgba(0, 0, 0, 0.7); }\n .navbar.is-light .navbar-start > a.navbar-item:focus, .navbar.is-light .navbar-start > a.navbar-item:hover, .navbar.is-light .navbar-start > a.navbar-item.is-active,\n .navbar.is-light .navbar-start .navbar-link:focus,\n .navbar.is-light .navbar-start .navbar-link:hover,\n .navbar.is-light .navbar-start .navbar-link.is-active,\n .navbar.is-light .navbar-end > a.navbar-item:focus,\n .navbar.is-light .navbar-end > a.navbar-item:hover,\n .navbar.is-light .navbar-end > a.navbar-item.is-active,\n .navbar.is-light .navbar-end .navbar-link:focus,\n .navbar.is-light .navbar-end .navbar-link:hover,\n .navbar.is-light .navbar-end .navbar-link.is-active {\n background-color: #e8e8e8;\n color: rgba(0, 0, 0, 0.7); }\n .navbar.is-light .navbar-start .navbar-link::after,\n .navbar.is-light .navbar-end .navbar-link::after {\n border-color: rgba(0, 0, 0, 0.7); }\n .navbar.is-light .navbar-item.has-dropdown:focus .navbar-link,\n .navbar.is-light .navbar-item.has-dropdown:hover .navbar-link,\n .navbar.is-light .navbar-item.has-dropdown.is-active .navbar-link {\n background-color: #e8e8e8;\n color: rgba(0, 0, 0, 0.7); }\n .navbar.is-light .navbar-dropdown a.navbar-item.is-active {\n background-color: whitesmoke;\n color: rgba(0, 0, 0, 0.7); } }\n .navbar.is-dark {\n background-color: #363636;\n color: #fff; }\n .navbar.is-dark .navbar-brand > .navbar-item,\n .navbar.is-dark .navbar-brand .navbar-link {\n color: #fff; }\n .navbar.is-dark .navbar-brand > a.navbar-item:focus, .navbar.is-dark .navbar-brand > a.navbar-item:hover, .navbar.is-dark .navbar-brand > a.navbar-item.is-active,\n .navbar.is-dark .navbar-brand .navbar-link:focus,\n .navbar.is-dark .navbar-brand .navbar-link:hover,\n .navbar.is-dark .navbar-brand .navbar-link.is-active {\n background-color: #292929;\n color: #fff; }\n .navbar.is-dark .navbar-brand .navbar-link::after {\n border-color: #fff; }\n .navbar.is-dark .navbar-burger {\n color: #fff; }\n @media screen and (min-width: 1024px) {\n .navbar.is-dark .navbar-start > .navbar-item,\n .navbar.is-dark .navbar-start .navbar-link,\n .navbar.is-dark .navbar-end > .navbar-item,\n .navbar.is-dark .navbar-end .navbar-link {\n color: #fff; }\n .navbar.is-dark .navbar-start > a.navbar-item:focus, .navbar.is-dark .navbar-start > a.navbar-item:hover, .navbar.is-dark .navbar-start > a.navbar-item.is-active,\n .navbar.is-dark .navbar-start .navbar-link:focus,\n .navbar.is-dark .navbar-start .navbar-link:hover,\n .navbar.is-dark .navbar-start .navbar-link.is-active,\n .navbar.is-dark .navbar-end > a.navbar-item:focus,\n .navbar.is-dark .navbar-end > a.navbar-item:hover,\n .navbar.is-dark .navbar-end > a.navbar-item.is-active,\n .navbar.is-dark .navbar-end .navbar-link:focus,\n .navbar.is-dark .navbar-end .navbar-link:hover,\n .navbar.is-dark .navbar-end .navbar-link.is-active {\n background-color: #292929;\n color: #fff; }\n .navbar.is-dark .navbar-start .navbar-link::after,\n .navbar.is-dark .navbar-end .navbar-link::after {\n border-color: #fff; }\n .navbar.is-dark .navbar-item.has-dropdown:focus .navbar-link,\n .navbar.is-dark .navbar-item.has-dropdown:hover .navbar-link,\n .navbar.is-dark .navbar-item.has-dropdown.is-active .navbar-link {\n background-color: #292929;\n color: #fff; }\n .navbar.is-dark .navbar-dropdown a.navbar-item.is-active {\n background-color: #363636;\n color: #fff; } }\n .navbar.is-primary {\n background-color: #ff0d68;\n color: #fff; }\n .navbar.is-primary .navbar-brand > .navbar-item,\n .navbar.is-primary .navbar-brand .navbar-link {\n color: #fff; }\n .navbar.is-primary .navbar-brand > a.navbar-item:focus, .navbar.is-primary .navbar-brand > a.navbar-item:hover, .navbar.is-primary .navbar-brand > a.navbar-item.is-active,\n .navbar.is-primary .navbar-brand .navbar-link:focus,\n .navbar.is-primary .navbar-brand .navbar-link:hover,\n .navbar.is-primary .navbar-brand .navbar-link.is-active {\n background-color: #f3005b;\n color: #fff; }\n .navbar.is-primary .navbar-brand .navbar-link::after {\n border-color: #fff; }\n .navbar.is-primary .navbar-burger {\n color: #fff; }\n @media screen and (min-width: 1024px) {\n .navbar.is-primary .navbar-start > .navbar-item,\n .navbar.is-primary .navbar-start .navbar-link,\n .navbar.is-primary .navbar-end > .navbar-item,\n .navbar.is-primary .navbar-end .navbar-link {\n color: #fff; }\n .navbar.is-primary .navbar-start > a.navbar-item:focus, .navbar.is-primary .navbar-start > a.navbar-item:hover, .navbar.is-primary .navbar-start > a.navbar-item.is-active,\n .navbar.is-primary .navbar-start .navbar-link:focus,\n .navbar.is-primary .navbar-start .navbar-link:hover,\n .navbar.is-primary .navbar-start .navbar-link.is-active,\n .navbar.is-primary .navbar-end > a.navbar-item:focus,\n .navbar.is-primary .navbar-end > a.navbar-item:hover,\n .navbar.is-primary .navbar-end > a.navbar-item.is-active,\n .navbar.is-primary .navbar-end .navbar-link:focus,\n .navbar.is-primary .navbar-end .navbar-link:hover,\n .navbar.is-primary .navbar-end .navbar-link.is-active {\n background-color: #f3005b;\n color: #fff; }\n .navbar.is-primary .navbar-start .navbar-link::after,\n .navbar.is-primary .navbar-end .navbar-link::after {\n border-color: #fff; }\n .navbar.is-primary .navbar-item.has-dropdown:focus .navbar-link,\n .navbar.is-primary .navbar-item.has-dropdown:hover .navbar-link,\n .navbar.is-primary .navbar-item.has-dropdown.is-active .navbar-link {\n background-color: #f3005b;\n color: #fff; }\n .navbar.is-primary .navbar-dropdown a.navbar-item.is-active {\n background-color: #ff0d68;\n color: #fff; } }\n .navbar.is-link {\n background-color: #ff0d68;\n color: #fff; }\n .navbar.is-link .navbar-brand > .navbar-item,\n .navbar.is-link .navbar-brand .navbar-link {\n color: #fff; }\n .navbar.is-link .navbar-brand > a.navbar-item:focus, .navbar.is-link .navbar-brand > a.navbar-item:hover, .navbar.is-link .navbar-brand > a.navbar-item.is-active,\n .navbar.is-link .navbar-brand .navbar-link:focus,\n .navbar.is-link .navbar-brand .navbar-link:hover,\n .navbar.is-link .navbar-brand .navbar-link.is-active {\n background-color: #f3005b;\n color: #fff; }\n .navbar.is-link .navbar-brand .navbar-link::after {\n border-color: #fff; }\n .navbar.is-link .navbar-burger {\n color: #fff; }\n @media screen and (min-width: 1024px) {\n .navbar.is-link .navbar-start > .navbar-item,\n .navbar.is-link .navbar-start .navbar-link,\n .navbar.is-link .navbar-end > .navbar-item,\n .navbar.is-link .navbar-end .navbar-link {\n color: #fff; }\n .navbar.is-link .navbar-start > a.navbar-item:focus, .navbar.is-link .navbar-start > a.navbar-item:hover, .navbar.is-link .navbar-start > a.navbar-item.is-active,\n .navbar.is-link .navbar-start .navbar-link:focus,\n .navbar.is-link .navbar-start .navbar-link:hover,\n .navbar.is-link .navbar-start .navbar-link.is-active,\n .navbar.is-link .navbar-end > a.navbar-item:focus,\n .navbar.is-link .navbar-end > a.navbar-item:hover,\n .navbar.is-link .navbar-end > a.navbar-item.is-active,\n .navbar.is-link .navbar-end .navbar-link:focus,\n .navbar.is-link .navbar-end .navbar-link:hover,\n .navbar.is-link .navbar-end .navbar-link.is-active {\n background-color: #f3005b;\n color: #fff; }\n .navbar.is-link .navbar-start .navbar-link::after,\n .navbar.is-link .navbar-end .navbar-link::after {\n border-color: #fff; }\n .navbar.is-link .navbar-item.has-dropdown:focus .navbar-link,\n .navbar.is-link .navbar-item.has-dropdown:hover .navbar-link,\n .navbar.is-link .navbar-item.has-dropdown.is-active .navbar-link {\n background-color: #f3005b;\n color: #fff; }\n .navbar.is-link .navbar-dropdown a.navbar-item.is-active {\n background-color: #ff0d68;\n color: #fff; } }\n .navbar.is-info {\n background-color: #0092FF;\n color: #fff; }\n .navbar.is-info .navbar-brand > .navbar-item,\n .navbar.is-info .navbar-brand .navbar-link {\n color: #fff; }\n .navbar.is-info .navbar-brand > a.navbar-item:focus, .navbar.is-info .navbar-brand > a.navbar-item:hover, .navbar.is-info .navbar-brand > a.navbar-item.is-active,\n .navbar.is-info .navbar-brand .navbar-link:focus,\n .navbar.is-info .navbar-brand .navbar-link:hover,\n .navbar.is-info .navbar-brand .navbar-link.is-active {\n background-color: #0083e6;\n color: #fff; }\n .navbar.is-info .navbar-brand .navbar-link::after {\n border-color: #fff; }\n .navbar.is-info .navbar-burger {\n color: #fff; }\n @media screen and (min-width: 1024px) {\n .navbar.is-info .navbar-start > .navbar-item,\n .navbar.is-info .navbar-start .navbar-link,\n .navbar.is-info .navbar-end > .navbar-item,\n .navbar.is-info .navbar-end .navbar-link {\n color: #fff; }\n .navbar.is-info .navbar-start > a.navbar-item:focus, .navbar.is-info .navbar-start > a.navbar-item:hover, .navbar.is-info .navbar-start > a.navbar-item.is-active,\n .navbar.is-info .navbar-start .navbar-link:focus,\n .navbar.is-info .navbar-start .navbar-link:hover,\n .navbar.is-info .navbar-start .navbar-link.is-active,\n .navbar.is-info .navbar-end > a.navbar-item:focus,\n .navbar.is-info .navbar-end > a.navbar-item:hover,\n .navbar.is-info .navbar-end > a.navbar-item.is-active,\n .navbar.is-info .navbar-end .navbar-link:focus,\n .navbar.is-info .navbar-end .navbar-link:hover,\n .navbar.is-info .navbar-end .navbar-link.is-active {\n background-color: #0083e6;\n color: #fff; }\n .navbar.is-info .navbar-start .navbar-link::after,\n .navbar.is-info .navbar-end .navbar-link::after {\n border-color: #fff; }\n .navbar.is-info .navbar-item.has-dropdown:focus .navbar-link,\n .navbar.is-info .navbar-item.has-dropdown:hover .navbar-link,\n .navbar.is-info .navbar-item.has-dropdown.is-active .navbar-link {\n background-color: #0083e6;\n color: #fff; }\n .navbar.is-info .navbar-dropdown a.navbar-item.is-active {\n background-color: #0092FF;\n color: #fff; } }\n .navbar.is-success {\n background-color: #16DB93;\n color: rgba(0, 0, 0, 0.7); }\n .navbar.is-success .navbar-brand > .navbar-item,\n .navbar.is-success .navbar-brand .navbar-link {\n color: rgba(0, 0, 0, 0.7); }\n .navbar.is-success .navbar-brand > a.navbar-item:focus, .navbar.is-success .navbar-brand > a.navbar-item:hover, .navbar.is-success .navbar-brand > a.navbar-item.is-active,\n .navbar.is-success .navbar-brand .navbar-link:focus,\n .navbar.is-success .navbar-brand .navbar-link:hover,\n .navbar.is-success .navbar-brand .navbar-link.is-active {\n background-color: #14c483;\n color: rgba(0, 0, 0, 0.7); }\n .navbar.is-success .navbar-brand .navbar-link::after {\n border-color: rgba(0, 0, 0, 0.7); }\n .navbar.is-success .navbar-burger {\n color: rgba(0, 0, 0, 0.7); }\n @media screen and (min-width: 1024px) {\n .navbar.is-success .navbar-start > .navbar-item,\n .navbar.is-success .navbar-start .navbar-link,\n .navbar.is-success .navbar-end > .navbar-item,\n .navbar.is-success .navbar-end .navbar-link {\n color: rgba(0, 0, 0, 0.7); }\n .navbar.is-success .navbar-start > a.navbar-item:focus, .navbar.is-success .navbar-start > a.navbar-item:hover, .navbar.is-success .navbar-start > a.navbar-item.is-active,\n .navbar.is-success .navbar-start .navbar-link:focus,\n .navbar.is-success .navbar-start .navbar-link:hover,\n .navbar.is-success .navbar-start .navbar-link.is-active,\n .navbar.is-success .navbar-end > a.navbar-item:focus,\n .navbar.is-success .navbar-end > a.navbar-item:hover,\n .navbar.is-success .navbar-end > a.navbar-item.is-active,\n .navbar.is-success .navbar-end .navbar-link:focus,\n .navbar.is-success .navbar-end .navbar-link:hover,\n .navbar.is-success .navbar-end .navbar-link.is-active {\n background-color: #14c483;\n color: rgba(0, 0, 0, 0.7); }\n .navbar.is-success .navbar-start .navbar-link::after,\n .navbar.is-success .navbar-end .navbar-link::after {\n border-color: rgba(0, 0, 0, 0.7); }\n .navbar.is-success .navbar-item.has-dropdown:focus .navbar-link,\n .navbar.is-success .navbar-item.has-dropdown:hover .navbar-link,\n .navbar.is-success .navbar-item.has-dropdown.is-active .navbar-link {\n background-color: #14c483;\n color: rgba(0, 0, 0, 0.7); }\n .navbar.is-success .navbar-dropdown a.navbar-item.is-active {\n background-color: #16DB93;\n color: rgba(0, 0, 0, 0.7); } }\n .navbar.is-warning {\n background-color: #FFE900;\n color: rgba(0, 0, 0, 0.7); }\n .navbar.is-warning .navbar-brand > .navbar-item,\n .navbar.is-warning .navbar-brand .navbar-link {\n color: rgba(0, 0, 0, 0.7); }\n .navbar.is-warning .navbar-brand > a.navbar-item:focus, .navbar.is-warning .navbar-brand > a.navbar-item:hover, .navbar.is-warning .navbar-brand > a.navbar-item.is-active,\n .navbar.is-warning .navbar-brand .navbar-link:focus,\n .navbar.is-warning .navbar-brand .navbar-link:hover,\n .navbar.is-warning .navbar-brand .navbar-link.is-active {\n background-color: #e6d200;\n color: rgba(0, 0, 0, 0.7); }\n .navbar.is-warning .navbar-brand .navbar-link::after {\n border-color: rgba(0, 0, 0, 0.7); }\n .navbar.is-warning .navbar-burger {\n color: rgba(0, 0, 0, 0.7); }\n @media screen and (min-width: 1024px) {\n .navbar.is-warning .navbar-start > .navbar-item,\n .navbar.is-warning .navbar-start .navbar-link,\n .navbar.is-warning .navbar-end > .navbar-item,\n .navbar.is-warning .navbar-end .navbar-link {\n color: rgba(0, 0, 0, 0.7); }\n .navbar.is-warning .navbar-start > a.navbar-item:focus, .navbar.is-warning .navbar-start > a.navbar-item:hover, .navbar.is-warning .navbar-start > a.navbar-item.is-active,\n .navbar.is-warning .navbar-start .navbar-link:focus,\n .navbar.is-warning .navbar-start .navbar-link:hover,\n .navbar.is-warning .navbar-start .navbar-link.is-active,\n .navbar.is-warning .navbar-end > a.navbar-item:focus,\n .navbar.is-warning .navbar-end > a.navbar-item:hover,\n .navbar.is-warning .navbar-end > a.navbar-item.is-active,\n .navbar.is-warning .navbar-end .navbar-link:focus,\n .navbar.is-warning .navbar-end .navbar-link:hover,\n .navbar.is-warning .navbar-end .navbar-link.is-active {\n background-color: #e6d200;\n color: rgba(0, 0, 0, 0.7); }\n .navbar.is-warning .navbar-start .navbar-link::after,\n .navbar.is-warning .navbar-end .navbar-link::after {\n border-color: rgba(0, 0, 0, 0.7); }\n .navbar.is-warning .navbar-item.has-dropdown:focus .navbar-link,\n .navbar.is-warning .navbar-item.has-dropdown:hover .navbar-link,\n .navbar.is-warning .navbar-item.has-dropdown.is-active .navbar-link {\n background-color: #e6d200;\n color: rgba(0, 0, 0, 0.7); }\n .navbar.is-warning .navbar-dropdown a.navbar-item.is-active {\n background-color: #FFE900;\n color: rgba(0, 0, 0, 0.7); } }\n .navbar.is-danger {\n background-color: #f14668;\n color: #fff; }\n .navbar.is-danger .navbar-brand > .navbar-item,\n .navbar.is-danger .navbar-brand .navbar-link {\n color: #fff; }\n .navbar.is-danger .navbar-brand > a.navbar-item:focus, .navbar.is-danger .navbar-brand > a.navbar-item:hover, .navbar.is-danger .navbar-brand > a.navbar-item.is-active,\n .navbar.is-danger .navbar-brand .navbar-link:focus,\n .navbar.is-danger .navbar-brand .navbar-link:hover,\n .navbar.is-danger .navbar-brand .navbar-link.is-active {\n background-color: #ef2e55;\n color: #fff; }\n .navbar.is-danger .navbar-brand .navbar-link::after {\n border-color: #fff; }\n .navbar.is-danger .navbar-burger {\n color: #fff; }\n @media screen and (min-width: 1024px) {\n .navbar.is-danger .navbar-start > .navbar-item,\n .navbar.is-danger .navbar-start .navbar-link,\n .navbar.is-danger .navbar-end > .navbar-item,\n .navbar.is-danger .navbar-end .navbar-link {\n color: #fff; }\n .navbar.is-danger .navbar-start > a.navbar-item:focus, .navbar.is-danger .navbar-start > a.navbar-item:hover, .navbar.is-danger .navbar-start > a.navbar-item.is-active,\n .navbar.is-danger .navbar-start .navbar-link:focus,\n .navbar.is-danger .navbar-start .navbar-link:hover,\n .navbar.is-danger .navbar-start .navbar-link.is-active,\n .navbar.is-danger .navbar-end > a.navbar-item:focus,\n .navbar.is-danger .navbar-end > a.navbar-item:hover,\n .navbar.is-danger .navbar-end > a.navbar-item.is-active,\n .navbar.is-danger .navbar-end .navbar-link:focus,\n .navbar.is-danger .navbar-end .navbar-link:hover,\n .navbar.is-danger .navbar-end .navbar-link.is-active {\n background-color: #ef2e55;\n color: #fff; }\n .navbar.is-danger .navbar-start .navbar-link::after,\n .navbar.is-danger .navbar-end .navbar-link::after {\n border-color: #fff; }\n .navbar.is-danger .navbar-item.has-dropdown:focus .navbar-link,\n .navbar.is-danger .navbar-item.has-dropdown:hover .navbar-link,\n .navbar.is-danger .navbar-item.has-dropdown.is-active .navbar-link {\n background-color: #ef2e55;\n color: #fff; }\n .navbar.is-danger .navbar-dropdown a.navbar-item.is-active {\n background-color: #f14668;\n color: #fff; } }\n .navbar > .container {\n align-items: stretch;\n display: flex;\n min-height: 3.25rem;\n width: 100%; }\n .navbar.has-shadow {\n box-shadow: 0 2px 0 0 whitesmoke; }\n .navbar.is-fixed-bottom, .navbar.is-fixed-top {\n left: 0;\n position: fixed;\n right: 0;\n z-index: 30; }\n .navbar.is-fixed-bottom {\n bottom: 0; }\n .navbar.is-fixed-bottom.has-shadow {\n box-shadow: 0 -2px 0 0 whitesmoke; }\n .navbar.is-fixed-top {\n top: 0; }\n\nhtml.has-navbar-fixed-top,\nbody.has-navbar-fixed-top {\n padding-top: 3.25rem; }\n\nhtml.has-navbar-fixed-bottom,\nbody.has-navbar-fixed-bottom {\n padding-bottom: 3.25rem; }\n\n.navbar-brand,\n.navbar-tabs {\n align-items: stretch;\n display: flex;\n flex-shrink: 0;\n min-height: 3.25rem; }\n\n.navbar-brand a.navbar-item:focus, .navbar-brand a.navbar-item:hover {\n background-color: transparent; }\n\n.navbar-tabs {\n -webkit-overflow-scrolling: touch;\n max-width: 100vw;\n overflow-x: auto;\n overflow-y: hidden; }\n\n.navbar-burger {\n color: #4a4a4a;\n -moz-appearance: none;\n -webkit-appearance: none;\n appearance: none;\n background: none;\n border: none;\n cursor: pointer;\n display: block;\n height: 3.25rem;\n position: relative;\n width: 3.25rem;\n margin-left: auto; }\n .navbar-burger span {\n background-color: currentColor;\n display: block;\n height: 1px;\n left: calc(50% - 8px);\n position: absolute;\n transform-origin: center;\n transition-duration: 86ms;\n transition-property: background-color, opacity, transform;\n transition-timing-function: ease-out;\n width: 16px; }\n .navbar-burger span:nth-child(1) {\n top: calc(50% - 6px); }\n .navbar-burger span:nth-child(2) {\n top: calc(50% - 1px); }\n .navbar-burger span:nth-child(3) {\n top: calc(50% + 4px); }\n .navbar-burger:hover {\n background-color: rgba(0, 0, 0, 0.05); }\n .navbar-burger.is-active span:nth-child(1) {\n transform: translateY(5px) rotate(45deg); }\n .navbar-burger.is-active span:nth-child(2) {\n opacity: 0; }\n .navbar-burger.is-active span:nth-child(3) {\n transform: translateY(-5px) rotate(-45deg); }\n\n.navbar-menu {\n display: none; }\n\n.navbar-item,\n.navbar-link {\n color: #4a4a4a;\n display: block;\n line-height: 1.5;\n padding: 0.5rem 0.75rem;\n position: relative; }\n .navbar-item .icon:only-child,\n .navbar-link .icon:only-child {\n margin-left: -0.25rem;\n margin-right: -0.25rem; }\n\na.navbar-item,\n.navbar-link {\n cursor: pointer; }\n a.navbar-item:focus, a.navbar-item:focus-within, a.navbar-item:hover, a.navbar-item.is-active,\n .navbar-link:focus,\n .navbar-link:focus-within,\n .navbar-link:hover,\n .navbar-link.is-active {\n background-color: #fafafa;\n color: #ff0d68; }\n\n.navbar-item {\n flex-grow: 0;\n flex-shrink: 0; }\n .navbar-item img {\n max-height: 1.75rem; }\n .navbar-item.has-dropdown {\n padding: 0; }\n .navbar-item.is-expanded {\n flex-grow: 1;\n flex-shrink: 1; }\n .navbar-item.is-tab {\n border-bottom: 1px solid transparent;\n min-height: 3.25rem;\n padding-bottom: calc(0.5rem - 1px); }\n .navbar-item.is-tab:focus, .navbar-item.is-tab:hover {\n background-color: transparent;\n border-bottom-color: #ff0d68; }\n .navbar-item.is-tab.is-active {\n background-color: transparent;\n border-bottom-color: #ff0d68;\n border-bottom-style: solid;\n border-bottom-width: 3px;\n color: #ff0d68;\n padding-bottom: calc(0.5rem - 3px); }\n\n.navbar-content {\n flex-grow: 1;\n flex-shrink: 1; }\n\n.navbar-link:not(.is-arrowless) {\n padding-right: 2.5em; }\n .navbar-link:not(.is-arrowless)::after {\n border-color: #ff0d68;\n margin-top: -0.375em;\n right: 1.125em; }\n\n.navbar-dropdown {\n font-size: 0.875rem;\n padding-bottom: 0.5rem;\n padding-top: 0.5rem; }\n .navbar-dropdown .navbar-item {\n padding-left: 1.5rem;\n padding-right: 1.5rem; }\n\n.navbar-divider {\n background-color: whitesmoke;\n border: none;\n display: none;\n height: 2px;\n margin: 0.5rem 0; }\n\n@media screen and (max-width: 1023px) {\n .navbar > .container {\n display: block; }\n .navbar-brand .navbar-item,\n .navbar-tabs .navbar-item {\n align-items: center;\n display: flex; }\n .navbar-link::after {\n display: none; }\n .navbar-menu {\n background-color: white;\n box-shadow: 0 8px 16px rgba(10, 10, 10, 0.1);\n padding: 0.5rem 0; }\n .navbar-menu.is-active {\n display: block; }\n .navbar.is-fixed-bottom-touch, .navbar.is-fixed-top-touch {\n left: 0;\n position: fixed;\n right: 0;\n z-index: 30; }\n .navbar.is-fixed-bottom-touch {\n bottom: 0; }\n .navbar.is-fixed-bottom-touch.has-shadow {\n box-shadow: 0 -2px 3px rgba(10, 10, 10, 0.1); }\n .navbar.is-fixed-top-touch {\n top: 0; }\n .navbar.is-fixed-top .navbar-menu, .navbar.is-fixed-top-touch .navbar-menu {\n -webkit-overflow-scrolling: touch;\n max-height: calc(100vh - 3.25rem);\n overflow: auto; }\n html.has-navbar-fixed-top-touch,\n body.has-navbar-fixed-top-touch {\n padding-top: 3.25rem; }\n html.has-navbar-fixed-bottom-touch,\n body.has-navbar-fixed-bottom-touch {\n padding-bottom: 3.25rem; } }\n\n@media screen and (min-width: 1024px) {\n .navbar,\n .navbar-menu,\n .navbar-start,\n .navbar-end {\n align-items: stretch;\n display: flex; }\n .navbar {\n min-height: 3.25rem; }\n .navbar.is-spaced {\n padding: 1rem 2rem; }\n .navbar.is-spaced .navbar-start,\n .navbar.is-spaced .navbar-end {\n align-items: center; }\n .navbar.is-spaced a.navbar-item,\n .navbar.is-spaced .navbar-link {\n border-radius: 4px; }\n .navbar.is-transparent a.navbar-item:focus, .navbar.is-transparent a.navbar-item:hover, .navbar.is-transparent a.navbar-item.is-active,\n .navbar.is-transparent .navbar-link:focus,\n .navbar.is-transparent .navbar-link:hover,\n .navbar.is-transparent .navbar-link.is-active {\n background-color: transparent !important; }\n .navbar.is-transparent .navbar-item.has-dropdown.is-active .navbar-link, .navbar.is-transparent .navbar-item.has-dropdown.is-hoverable:focus .navbar-link, .navbar.is-transparent .navbar-item.has-dropdown.is-hoverable:focus-within .navbar-link, .navbar.is-transparent .navbar-item.has-dropdown.is-hoverable:hover .navbar-link {\n background-color: transparent !important; }\n .navbar.is-transparent .navbar-dropdown a.navbar-item:focus, .navbar.is-transparent .navbar-dropdown a.navbar-item:hover {\n background-color: whitesmoke;\n color: #0a0a0a; }\n .navbar.is-transparent .navbar-dropdown a.navbar-item.is-active {\n background-color: whitesmoke;\n color: #ff0d68; }\n .navbar-burger {\n display: none; }\n .navbar-item,\n .navbar-link {\n align-items: center;\n display: flex; }\n .navbar-item.has-dropdown {\n align-items: stretch; }\n .navbar-item.has-dropdown-up .navbar-link::after {\n transform: rotate(135deg) translate(0.25em, -0.25em); }\n .navbar-item.has-dropdown-up .navbar-dropdown {\n border-bottom: 2px solid #dbdbdb;\n border-radius: 6px 6px 0 0;\n border-top: none;\n bottom: 100%;\n box-shadow: 0 -8px 8px rgba(10, 10, 10, 0.1);\n top: auto; }\n .navbar-item.is-active .navbar-dropdown, .navbar-item.is-hoverable:focus .navbar-dropdown, .navbar-item.is-hoverable:focus-within .navbar-dropdown, .navbar-item.is-hoverable:hover .navbar-dropdown {\n display: block; }\n .navbar.is-spaced .navbar-item.is-active .navbar-dropdown, .navbar-item.is-active .navbar-dropdown.is-boxed, .navbar.is-spaced .navbar-item.is-hoverable:focus .navbar-dropdown, .navbar-item.is-hoverable:focus .navbar-dropdown.is-boxed, .navbar.is-spaced .navbar-item.is-hoverable:focus-within .navbar-dropdown, .navbar-item.is-hoverable:focus-within .navbar-dropdown.is-boxed, .navbar.is-spaced .navbar-item.is-hoverable:hover .navbar-dropdown, .navbar-item.is-hoverable:hover .navbar-dropdown.is-boxed {\n opacity: 1;\n pointer-events: auto;\n transform: translateY(0); }\n .navbar-menu {\n flex-grow: 1;\n flex-shrink: 0; }\n .navbar-start {\n justify-content: flex-start;\n margin-right: auto; }\n .navbar-end {\n justify-content: flex-end;\n margin-left: auto; }\n .navbar-dropdown {\n background-color: white;\n border-bottom-left-radius: 6px;\n border-bottom-right-radius: 6px;\n border-top: 2px solid #dbdbdb;\n box-shadow: 0 8px 8px rgba(10, 10, 10, 0.1);\n display: none;\n font-size: 0.875rem;\n left: 0;\n min-width: 100%;\n position: absolute;\n top: 100%;\n z-index: 20; }\n .navbar-dropdown .navbar-item {\n padding: 0.375rem 1rem;\n white-space: nowrap; }\n .navbar-dropdown a.navbar-item {\n padding-right: 3rem; }\n .navbar-dropdown a.navbar-item:focus, .navbar-dropdown a.navbar-item:hover {\n background-color: whitesmoke;\n color: #0a0a0a; }\n .navbar-dropdown a.navbar-item.is-active {\n background-color: whitesmoke;\n color: #ff0d68; }\n .navbar.is-spaced .navbar-dropdown, .navbar-dropdown.is-boxed {\n border-radius: 6px;\n border-top: none;\n box-shadow: 0 8px 8px rgba(10, 10, 10, 0.1), 0 0 0 1px rgba(10, 10, 10, 0.1);\n display: block;\n opacity: 0;\n pointer-events: none;\n top: calc(100% + (-4px));\n transform: translateY(-5px);\n transition-duration: 86ms;\n transition-property: opacity, transform; }\n .navbar-dropdown.is-right {\n left: auto;\n right: 0; }\n .navbar-divider {\n display: block; }\n .navbar > .container .navbar-brand,\n .container > .navbar .navbar-brand {\n margin-left: -0.75rem; }\n .navbar > .container .navbar-menu,\n .container > .navbar .navbar-menu {\n margin-right: -0.75rem; }\n .navbar.is-fixed-bottom-desktop, .navbar.is-fixed-top-desktop {\n left: 0;\n position: fixed;\n right: 0;\n z-index: 30; }\n .navbar.is-fixed-bottom-desktop {\n bottom: 0; }\n .navbar.is-fixed-bottom-desktop.has-shadow {\n box-shadow: 0 -2px 3px rgba(10, 10, 10, 0.1); }\n .navbar.is-fixed-top-desktop {\n top: 0; }\n html.has-navbar-fixed-top-desktop,\n body.has-navbar-fixed-top-desktop {\n padding-top: 3.25rem; }\n html.has-navbar-fixed-bottom-desktop,\n body.has-navbar-fixed-bottom-desktop {\n padding-bottom: 3.25rem; }\n html.has-spaced-navbar-fixed-top,\n body.has-spaced-navbar-fixed-top {\n padding-top: 5.25rem; }\n html.has-spaced-navbar-fixed-bottom,\n body.has-spaced-navbar-fixed-bottom {\n padding-bottom: 5.25rem; }\n a.navbar-item.is-active,\n .navbar-link.is-active {\n color: #0a0a0a; }\n a.navbar-item.is-active:not(:focus):not(:hover),\n .navbar-link.is-active:not(:focus):not(:hover) {\n background-color: transparent; }\n .navbar-item.has-dropdown:focus .navbar-link, .navbar-item.has-dropdown:hover .navbar-link, .navbar-item.has-dropdown.is-active .navbar-link {\n background-color: #fafafa; } }\n\n.hero.is-fullheight-with-navbar {\n min-height: calc(100vh - 3.25rem); }\n\n.pagination {\n font-size: 1rem;\n margin: -0.25rem; }\n .pagination.is-small {\n font-size: 0.75rem; }\n .pagination.is-medium {\n font-size: 1.25rem; }\n .pagination.is-large {\n font-size: 1.5rem; }\n .pagination.is-rounded .pagination-previous,\n .pagination.is-rounded .pagination-next {\n padding-left: 1em;\n padding-right: 1em;\n border-radius: 9999px; }\n .pagination.is-rounded .pagination-link {\n border-radius: 9999px; }\n\n.pagination,\n.pagination-list {\n align-items: center;\n display: flex;\n justify-content: center;\n text-align: center; }\n\n.pagination-previous,\n.pagination-next,\n.pagination-link,\n.pagination-ellipsis {\n font-size: 1em;\n justify-content: center;\n margin: 0.25rem;\n padding-left: 0.5em;\n padding-right: 0.5em;\n text-align: center; }\n\n.pagination-previous,\n.pagination-next,\n.pagination-link {\n border-color: #dbdbdb;\n color: #363636;\n min-width: 2.5em; }\n .pagination-previous:hover,\n .pagination-next:hover,\n .pagination-link:hover {\n border-color: #b5b5b5;\n color: #363636; }\n .pagination-previous:focus,\n .pagination-next:focus,\n .pagination-link:focus {\n border-color: #0092FF; }\n .pagination-previous:active,\n .pagination-next:active,\n .pagination-link:active {\n box-shadow: inset 0 1px 2px rgba(10, 10, 10, 0.2); }\n .pagination-previous[disabled], .pagination-previous.is-disabled,\n .pagination-next[disabled],\n .pagination-next.is-disabled,\n .pagination-link[disabled],\n .pagination-link.is-disabled {\n background-color: #dbdbdb;\n border-color: #dbdbdb;\n box-shadow: none;\n color: #7a7a7a;\n opacity: 0.5; }\n\n.pagination-previous,\n.pagination-next {\n padding-left: 0.75em;\n padding-right: 0.75em;\n white-space: nowrap; }\n\n.pagination-link.is-current {\n background-color: #ff0d68;\n border-color: #ff0d68;\n color: #fff; }\n\n.pagination-ellipsis {\n color: #b5b5b5;\n pointer-events: none; }\n\n.pagination-list {\n flex-wrap: wrap; }\n .pagination-list li {\n list-style: none; }\n\n@media screen and (max-width: 768px) {\n .pagination {\n flex-wrap: wrap; }\n .pagination-previous,\n .pagination-next {\n flex-grow: 1;\n flex-shrink: 1; }\n .pagination-list li {\n flex-grow: 1;\n flex-shrink: 1; } }\n\n@media screen and (min-width: 769px), print {\n .pagination-list {\n flex-grow: 1;\n flex-shrink: 1;\n justify-content: flex-start;\n order: 1; }\n .pagination-previous,\n .pagination-next,\n .pagination-link,\n .pagination-ellipsis {\n margin-bottom: 0;\n margin-top: 0; }\n .pagination-previous {\n order: 2; }\n .pagination-next {\n order: 3; }\n .pagination {\n justify-content: space-between;\n margin-bottom: 0;\n margin-top: 0; }\n .pagination.is-centered .pagination-previous {\n order: 1; }\n .pagination.is-centered .pagination-list {\n justify-content: center;\n order: 2; }\n .pagination.is-centered .pagination-next {\n order: 3; }\n .pagination.is-right .pagination-previous {\n order: 1; }\n .pagination.is-right .pagination-next {\n order: 2; }\n .pagination.is-right .pagination-list {\n justify-content: flex-end;\n order: 3; } }\n\n.panel {\n border-radius: 6px;\n box-shadow: 0 0.5em 1em -0.125em rgba(10, 10, 10, 0.1), 0 0px 0 1px rgba(10, 10, 10, 0.02);\n font-size: 1rem; }\n .panel:not(:last-child) {\n margin-bottom: 1.5rem; }\n .panel.is-white .panel-heading {\n background-color: white;\n color: #0a0a0a; }\n .panel.is-white .panel-tabs a.is-active {\n border-bottom-color: white; }\n .panel.is-white .panel-block.is-active .panel-icon {\n color: white; }\n .panel.is-black .panel-heading {\n background-color: #0a0a0a;\n color: white; }\n .panel.is-black .panel-tabs a.is-active {\n border-bottom-color: #0a0a0a; }\n .panel.is-black .panel-block.is-active .panel-icon {\n color: #0a0a0a; }\n .panel.is-light .panel-heading {\n background-color: whitesmoke;\n color: rgba(0, 0, 0, 0.7); }\n .panel.is-light .panel-tabs a.is-active {\n border-bottom-color: whitesmoke; }\n .panel.is-light .panel-block.is-active .panel-icon {\n color: whitesmoke; }\n .panel.is-dark .panel-heading {\n background-color: #363636;\n color: #fff; }\n .panel.is-dark .panel-tabs a.is-active {\n border-bottom-color: #363636; }\n .panel.is-dark .panel-block.is-active .panel-icon {\n color: #363636; }\n .panel.is-primary .panel-heading {\n background-color: #ff0d68;\n color: #fff; }\n .panel.is-primary .panel-tabs a.is-active {\n border-bottom-color: #ff0d68; }\n .panel.is-primary .panel-block.is-active .panel-icon {\n color: #ff0d68; }\n .panel.is-link .panel-heading {\n background-color: #ff0d68;\n color: #fff; }\n .panel.is-link .panel-tabs a.is-active {\n border-bottom-color: #ff0d68; }\n .panel.is-link .panel-block.is-active .panel-icon {\n color: #ff0d68; }\n .panel.is-info .panel-heading {\n background-color: #0092FF;\n color: #fff; }\n .panel.is-info .panel-tabs a.is-active {\n border-bottom-color: #0092FF; }\n .panel.is-info .panel-block.is-active .panel-icon {\n color: #0092FF; }\n .panel.is-success .panel-heading {\n background-color: #16DB93;\n color: rgba(0, 0, 0, 0.7); }\n .panel.is-success .panel-tabs a.is-active {\n border-bottom-color: #16DB93; }\n .panel.is-success .panel-block.is-active .panel-icon {\n color: #16DB93; }\n .panel.is-warning .panel-heading {\n background-color: #FFE900;\n color: rgba(0, 0, 0, 0.7); }\n .panel.is-warning .panel-tabs a.is-active {\n border-bottom-color: #FFE900; }\n .panel.is-warning .panel-block.is-active .panel-icon {\n color: #FFE900; }\n .panel.is-danger .panel-heading {\n background-color: #f14668;\n color: #fff; }\n .panel.is-danger .panel-tabs a.is-active {\n border-bottom-color: #f14668; }\n .panel.is-danger .panel-block.is-active .panel-icon {\n color: #f14668; }\n\n.panel-tabs:not(:last-child),\n.panel-block:not(:last-child) {\n border-bottom: 1px solid #ededed; }\n\n.panel-heading {\n background-color: #ededed;\n border-radius: 6px 6px 0 0;\n color: #363636;\n font-size: 1.25em;\n font-weight: 700;\n line-height: 1.25;\n padding: 0.75em 1em; }\n\n.panel-tabs {\n align-items: flex-end;\n display: flex;\n font-size: 0.875em;\n justify-content: center; }\n .panel-tabs a {\n border-bottom: 1px solid #dbdbdb;\n margin-bottom: -1px;\n padding: 0.5em; }\n .panel-tabs a.is-active {\n border-bottom-color: #4a4a4a;\n color: #363636; }\n\n.panel-list a {\n color: #4a4a4a; }\n .panel-list a:hover {\n color: #ff0d68; }\n\n.panel-block {\n align-items: center;\n color: #363636;\n display: flex;\n justify-content: flex-start;\n padding: 0.5em 0.75em; }\n .panel-block input[type=\"checkbox\"] {\n margin-right: 0.75em; }\n .panel-block > .control {\n flex-grow: 1;\n flex-shrink: 1;\n width: 100%; }\n .panel-block.is-wrapped {\n flex-wrap: wrap; }\n .panel-block.is-active {\n border-left-color: #ff0d68;\n color: #363636; }\n .panel-block.is-active .panel-icon {\n color: #ff0d68; }\n .panel-block:last-child {\n border-bottom-left-radius: 6px;\n border-bottom-right-radius: 6px; }\n\na.panel-block,\nlabel.panel-block {\n cursor: pointer; }\n a.panel-block:hover,\n label.panel-block:hover {\n background-color: whitesmoke; }\n\n.panel-icon {\n display: inline-block;\n font-size: 14px;\n height: 1em;\n line-height: 1em;\n text-align: center;\n vertical-align: top;\n width: 1em;\n color: #7a7a7a;\n margin-right: 0.75em; }\n .panel-icon .fa {\n font-size: inherit;\n line-height: inherit; }\n\n.tabs {\n -webkit-overflow-scrolling: touch;\n align-items: stretch;\n display: flex;\n font-size: 1rem;\n justify-content: space-between;\n overflow: hidden;\n overflow-x: auto;\n white-space: nowrap; }\n .tabs a {\n align-items: center;\n border-bottom-color: #dbdbdb;\n border-bottom-style: solid;\n border-bottom-width: 1px;\n color: #4a4a4a;\n display: flex;\n justify-content: center;\n margin-bottom: -1px;\n padding: 0.5em 1em;\n vertical-align: top; }\n .tabs a:hover {\n border-bottom-color: #363636;\n color: #363636; }\n .tabs li {\n display: block; }\n .tabs li.is-active a {\n border-bottom-color: #ff0d68;\n color: #ff0d68; }\n .tabs ul {\n align-items: center;\n border-bottom-color: #dbdbdb;\n border-bottom-style: solid;\n border-bottom-width: 1px;\n display: flex;\n flex-grow: 1;\n flex-shrink: 0;\n justify-content: flex-start; }\n .tabs ul.is-left {\n padding-right: 0.75em; }\n .tabs ul.is-center {\n flex: none;\n justify-content: center;\n padding-left: 0.75em;\n padding-right: 0.75em; }\n .tabs ul.is-right {\n justify-content: flex-end;\n padding-left: 0.75em; }\n .tabs .icon:first-child {\n margin-right: 0.5em; }\n .tabs .icon:last-child {\n margin-left: 0.5em; }\n .tabs.is-centered ul {\n justify-content: center; }\n .tabs.is-right ul {\n justify-content: flex-end; }\n .tabs.is-boxed a {\n border: 1px solid transparent;\n border-radius: 4px 4px 0 0; }\n .tabs.is-boxed a:hover {\n background-color: whitesmoke;\n border-bottom-color: #dbdbdb; }\n .tabs.is-boxed li.is-active a {\n background-color: white;\n border-color: #dbdbdb;\n border-bottom-color: transparent !important; }\n .tabs.is-fullwidth li {\n flex-grow: 1;\n flex-shrink: 0; }\n .tabs.is-toggle a {\n border-color: #dbdbdb;\n border-style: solid;\n border-width: 1px;\n margin-bottom: 0;\n position: relative; }\n .tabs.is-toggle a:hover {\n background-color: whitesmoke;\n border-color: #b5b5b5;\n z-index: 2; }\n .tabs.is-toggle li + li {\n margin-left: -1px; }\n .tabs.is-toggle li:first-child a {\n border-top-left-radius: 4px;\n border-bottom-left-radius: 4px; }\n .tabs.is-toggle li:last-child a {\n border-top-right-radius: 4px;\n border-bottom-right-radius: 4px; }\n .tabs.is-toggle li.is-active a {\n background-color: #ff0d68;\n border-color: #ff0d68;\n color: #fff;\n z-index: 1; }\n .tabs.is-toggle ul {\n border-bottom: none; }\n .tabs.is-toggle.is-toggle-rounded li:first-child a {\n border-bottom-left-radius: 9999px;\n border-top-left-radius: 9999px;\n padding-left: 1.25em; }\n .tabs.is-toggle.is-toggle-rounded li:last-child a {\n border-bottom-right-radius: 9999px;\n border-top-right-radius: 9999px;\n padding-right: 1.25em; }\n .tabs.is-small {\n font-size: 0.75rem; }\n .tabs.is-medium {\n font-size: 1.25rem; }\n .tabs.is-large {\n font-size: 1.5rem; }\n\n/* Bulma Grid */\n.column {\n display: block;\n flex-basis: 0;\n flex-grow: 1;\n flex-shrink: 1;\n padding: 0.75rem; }\n .columns.is-mobile > .column.is-narrow {\n flex: none;\n width: unset; }\n .columns.is-mobile > .column.is-full {\n flex: none;\n width: 100%; }\n .columns.is-mobile > .column.is-three-quarters {\n flex: none;\n width: 75%; }\n .columns.is-mobile > .column.is-two-thirds {\n flex: none;\n width: 66.6666%; }\n .columns.is-mobile > .column.is-half {\n flex: none;\n width: 50%; }\n .columns.is-mobile > .column.is-one-third {\n flex: none;\n width: 33.3333%; }\n .columns.is-mobile > .column.is-one-quarter {\n flex: none;\n width: 25%; }\n .columns.is-mobile > .column.is-one-fifth {\n flex: none;\n width: 20%; }\n .columns.is-mobile > .column.is-two-fifths {\n flex: none;\n width: 40%; }\n .columns.is-mobile > .column.is-three-fifths {\n flex: none;\n width: 60%; }\n .columns.is-mobile > .column.is-four-fifths {\n flex: none;\n width: 80%; }\n .columns.is-mobile > .column.is-offset-three-quarters {\n margin-left: 75%; }\n .columns.is-mobile > .column.is-offset-two-thirds {\n margin-left: 66.6666%; }\n .columns.is-mobile > .column.is-offset-half {\n margin-left: 50%; }\n .columns.is-mobile > .column.is-offset-one-third {\n margin-left: 33.3333%; }\n .columns.is-mobile > .column.is-offset-one-quarter {\n margin-left: 25%; }\n .columns.is-mobile > .column.is-offset-one-fifth {\n margin-left: 20%; }\n .columns.is-mobile > .column.is-offset-two-fifths {\n margin-left: 40%; }\n .columns.is-mobile > .column.is-offset-three-fifths {\n margin-left: 60%; }\n .columns.is-mobile > .column.is-offset-four-fifths {\n margin-left: 80%; }\n .columns.is-mobile > .column.is-0 {\n flex: none;\n width: 0%; }\n .columns.is-mobile > .column.is-offset-0 {\n margin-left: 0%; }\n .columns.is-mobile > .column.is-1 {\n flex: none;\n width: 8.33333%; }\n .columns.is-mobile > .column.is-offset-1 {\n margin-left: 8.33333%; }\n .columns.is-mobile > .column.is-2 {\n flex: none;\n width: 16.66667%; }\n .columns.is-mobile > .column.is-offset-2 {\n margin-left: 16.66667%; }\n .columns.is-mobile > .column.is-3 {\n flex: none;\n width: 25%; }\n .columns.is-mobile > .column.is-offset-3 {\n margin-left: 25%; }\n .columns.is-mobile > .column.is-4 {\n flex: none;\n width: 33.33333%; }\n .columns.is-mobile > .column.is-offset-4 {\n margin-left: 33.33333%; }\n .columns.is-mobile > .column.is-5 {\n flex: none;\n width: 41.66667%; }\n .columns.is-mobile > .column.is-offset-5 {\n margin-left: 41.66667%; }\n .columns.is-mobile > .column.is-6 {\n flex: none;\n width: 50%; }\n .columns.is-mobile > .column.is-offset-6 {\n margin-left: 50%; }\n .columns.is-mobile > .column.is-7 {\n flex: none;\n width: 58.33333%; }\n .columns.is-mobile > .column.is-offset-7 {\n margin-left: 58.33333%; }\n .columns.is-mobile > .column.is-8 {\n flex: none;\n width: 66.66667%; }\n .columns.is-mobile > .column.is-offset-8 {\n margin-left: 66.66667%; }\n .columns.is-mobile > .column.is-9 {\n flex: none;\n width: 75%; }\n .columns.is-mobile > .column.is-offset-9 {\n margin-left: 75%; }\n .columns.is-mobile > .column.is-10 {\n flex: none;\n width: 83.33333%; }\n .columns.is-mobile > .column.is-offset-10 {\n margin-left: 83.33333%; }\n .columns.is-mobile > .column.is-11 {\n flex: none;\n width: 91.66667%; }\n .columns.is-mobile > .column.is-offset-11 {\n margin-left: 91.66667%; }\n .columns.is-mobile > .column.is-12 {\n flex: none;\n width: 100%; }\n .columns.is-mobile > .column.is-offset-12 {\n margin-left: 100%; }\n @media screen and (max-width: 768px) {\n .column.is-narrow-mobile {\n flex: none;\n width: unset; }\n .column.is-full-mobile {\n flex: none;\n width: 100%; }\n .column.is-three-quarters-mobile {\n flex: none;\n width: 75%; }\n .column.is-two-thirds-mobile {\n flex: none;\n width: 66.6666%; }\n .column.is-half-mobile {\n flex: none;\n width: 50%; }\n .column.is-one-third-mobile {\n flex: none;\n width: 33.3333%; }\n .column.is-one-quarter-mobile {\n flex: none;\n width: 25%; }\n .column.is-one-fifth-mobile {\n flex: none;\n width: 20%; }\n .column.is-two-fifths-mobile {\n flex: none;\n width: 40%; }\n .column.is-three-fifths-mobile {\n flex: none;\n width: 60%; }\n .column.is-four-fifths-mobile {\n flex: none;\n width: 80%; }\n .column.is-offset-three-quarters-mobile {\n margin-left: 75%; }\n .column.is-offset-two-thirds-mobile {\n margin-left: 66.6666%; }\n .column.is-offset-half-mobile {\n margin-left: 50%; }\n .column.is-offset-one-third-mobile {\n margin-left: 33.3333%; }\n .column.is-offset-one-quarter-mobile {\n margin-left: 25%; }\n .column.is-offset-one-fifth-mobile {\n margin-left: 20%; }\n .column.is-offset-two-fifths-mobile {\n margin-left: 40%; }\n .column.is-offset-three-fifths-mobile {\n margin-left: 60%; }\n .column.is-offset-four-fifths-mobile {\n margin-left: 80%; }\n .column.is-0-mobile {\n flex: none;\n width: 0%; }\n .column.is-offset-0-mobile {\n margin-left: 0%; }\n .column.is-1-mobile {\n flex: none;\n width: 8.33333%; }\n .column.is-offset-1-mobile {\n margin-left: 8.33333%; }\n .column.is-2-mobile {\n flex: none;\n width: 16.66667%; }\n .column.is-offset-2-mobile {\n margin-left: 16.66667%; }\n .column.is-3-mobile {\n flex: none;\n width: 25%; }\n .column.is-offset-3-mobile {\n margin-left: 25%; }\n .column.is-4-mobile {\n flex: none;\n width: 33.33333%; }\n .column.is-offset-4-mobile {\n margin-left: 33.33333%; }\n .column.is-5-mobile {\n flex: none;\n width: 41.66667%; }\n .column.is-offset-5-mobile {\n margin-left: 41.66667%; }\n .column.is-6-mobile {\n flex: none;\n width: 50%; }\n .column.is-offset-6-mobile {\n margin-left: 50%; }\n .column.is-7-mobile {\n flex: none;\n width: 58.33333%; }\n .column.is-offset-7-mobile {\n margin-left: 58.33333%; }\n .column.is-8-mobile {\n flex: none;\n width: 66.66667%; }\n .column.is-offset-8-mobile {\n margin-left: 66.66667%; }\n .column.is-9-mobile {\n flex: none;\n width: 75%; }\n .column.is-offset-9-mobile {\n margin-left: 75%; }\n .column.is-10-mobile {\n flex: none;\n width: 83.33333%; }\n .column.is-offset-10-mobile {\n margin-left: 83.33333%; }\n .column.is-11-mobile {\n flex: none;\n width: 91.66667%; }\n .column.is-offset-11-mobile {\n margin-left: 91.66667%; }\n .column.is-12-mobile {\n flex: none;\n width: 100%; }\n .column.is-offset-12-mobile {\n margin-left: 100%; } }\n @media screen and (min-width: 769px), print {\n .column.is-narrow, .column.is-narrow-tablet {\n flex: none;\n width: unset; }\n .column.is-full, .column.is-full-tablet {\n flex: none;\n width: 100%; }\n .column.is-three-quarters, .column.is-three-quarters-tablet {\n flex: none;\n width: 75%; }\n .column.is-two-thirds, .column.is-two-thirds-tablet {\n flex: none;\n width: 66.6666%; }\n .column.is-half, .column.is-half-tablet {\n flex: none;\n width: 50%; }\n .column.is-one-third, .column.is-one-third-tablet {\n flex: none;\n width: 33.3333%; }\n .column.is-one-quarter, .column.is-one-quarter-tablet {\n flex: none;\n width: 25%; }\n .column.is-one-fifth, .column.is-one-fifth-tablet {\n flex: none;\n width: 20%; }\n .column.is-two-fifths, .column.is-two-fifths-tablet {\n flex: none;\n width: 40%; }\n .column.is-three-fifths, .column.is-three-fifths-tablet {\n flex: none;\n width: 60%; }\n .column.is-four-fifths, .column.is-four-fifths-tablet {\n flex: none;\n width: 80%; }\n .column.is-offset-three-quarters, .column.is-offset-three-quarters-tablet {\n margin-left: 75%; }\n .column.is-offset-two-thirds, .column.is-offset-two-thirds-tablet {\n margin-left: 66.6666%; }\n .column.is-offset-half, .column.is-offset-half-tablet {\n margin-left: 50%; }\n .column.is-offset-one-third, .column.is-offset-one-third-tablet {\n margin-left: 33.3333%; }\n .column.is-offset-one-quarter, .column.is-offset-one-quarter-tablet {\n margin-left: 25%; }\n .column.is-offset-one-fifth, .column.is-offset-one-fifth-tablet {\n margin-left: 20%; }\n .column.is-offset-two-fifths, .column.is-offset-two-fifths-tablet {\n margin-left: 40%; }\n .column.is-offset-three-fifths, .column.is-offset-three-fifths-tablet {\n margin-left: 60%; }\n .column.is-offset-four-fifths, .column.is-offset-four-fifths-tablet {\n margin-left: 80%; }\n .column.is-0, .column.is-0-tablet {\n flex: none;\n width: 0%; }\n .column.is-offset-0, .column.is-offset-0-tablet {\n margin-left: 0%; }\n .column.is-1, .column.is-1-tablet {\n flex: none;\n width: 8.33333%; }\n .column.is-offset-1, .column.is-offset-1-tablet {\n margin-left: 8.33333%; }\n .column.is-2, .column.is-2-tablet {\n flex: none;\n width: 16.66667%; }\n .column.is-offset-2, .column.is-offset-2-tablet {\n margin-left: 16.66667%; }\n .column.is-3, .column.is-3-tablet {\n flex: none;\n width: 25%; }\n .column.is-offset-3, .column.is-offset-3-tablet {\n margin-left: 25%; }\n .column.is-4, .column.is-4-tablet {\n flex: none;\n width: 33.33333%; }\n .column.is-offset-4, .column.is-offset-4-tablet {\n margin-left: 33.33333%; }\n .column.is-5, .column.is-5-tablet {\n flex: none;\n width: 41.66667%; }\n .column.is-offset-5, .column.is-offset-5-tablet {\n margin-left: 41.66667%; }\n .column.is-6, .column.is-6-tablet {\n flex: none;\n width: 50%; }\n .column.is-offset-6, .column.is-offset-6-tablet {\n margin-left: 50%; }\n .column.is-7, .column.is-7-tablet {\n flex: none;\n width: 58.33333%; }\n .column.is-offset-7, .column.is-offset-7-tablet {\n margin-left: 58.33333%; }\n .column.is-8, .column.is-8-tablet {\n flex: none;\n width: 66.66667%; }\n .column.is-offset-8, .column.is-offset-8-tablet {\n margin-left: 66.66667%; }\n .column.is-9, .column.is-9-tablet {\n flex: none;\n width: 75%; }\n .column.is-offset-9, .column.is-offset-9-tablet {\n margin-left: 75%; }\n .column.is-10, .column.is-10-tablet {\n flex: none;\n width: 83.33333%; }\n .column.is-offset-10, .column.is-offset-10-tablet {\n margin-left: 83.33333%; }\n .column.is-11, .column.is-11-tablet {\n flex: none;\n width: 91.66667%; }\n .column.is-offset-11, .column.is-offset-11-tablet {\n margin-left: 91.66667%; }\n .column.is-12, .column.is-12-tablet {\n flex: none;\n width: 100%; }\n .column.is-offset-12, .column.is-offset-12-tablet {\n margin-left: 100%; } }\n @media screen and (max-width: 1023px) {\n .column.is-narrow-touch {\n flex: none;\n width: unset; }\n .column.is-full-touch {\n flex: none;\n width: 100%; }\n .column.is-three-quarters-touch {\n flex: none;\n width: 75%; }\n .column.is-two-thirds-touch {\n flex: none;\n width: 66.6666%; }\n .column.is-half-touch {\n flex: none;\n width: 50%; }\n .column.is-one-third-touch {\n flex: none;\n width: 33.3333%; }\n .column.is-one-quarter-touch {\n flex: none;\n width: 25%; }\n .column.is-one-fifth-touch {\n flex: none;\n width: 20%; }\n .column.is-two-fifths-touch {\n flex: none;\n width: 40%; }\n .column.is-three-fifths-touch {\n flex: none;\n width: 60%; }\n .column.is-four-fifths-touch {\n flex: none;\n width: 80%; }\n .column.is-offset-three-quarters-touch {\n margin-left: 75%; }\n .column.is-offset-two-thirds-touch {\n margin-left: 66.6666%; }\n .column.is-offset-half-touch {\n margin-left: 50%; }\n .column.is-offset-one-third-touch {\n margin-left: 33.3333%; }\n .column.is-offset-one-quarter-touch {\n margin-left: 25%; }\n .column.is-offset-one-fifth-touch {\n margin-left: 20%; }\n .column.is-offset-two-fifths-touch {\n margin-left: 40%; }\n .column.is-offset-three-fifths-touch {\n margin-left: 60%; }\n .column.is-offset-four-fifths-touch {\n margin-left: 80%; }\n .column.is-0-touch {\n flex: none;\n width: 0%; }\n .column.is-offset-0-touch {\n margin-left: 0%; }\n .column.is-1-touch {\n flex: none;\n width: 8.33333%; }\n .column.is-offset-1-touch {\n margin-left: 8.33333%; }\n .column.is-2-touch {\n flex: none;\n width: 16.66667%; }\n .column.is-offset-2-touch {\n margin-left: 16.66667%; }\n .column.is-3-touch {\n flex: none;\n width: 25%; }\n .column.is-offset-3-touch {\n margin-left: 25%; }\n .column.is-4-touch {\n flex: none;\n width: 33.33333%; }\n .column.is-offset-4-touch {\n margin-left: 33.33333%; }\n .column.is-5-touch {\n flex: none;\n width: 41.66667%; }\n .column.is-offset-5-touch {\n margin-left: 41.66667%; }\n .column.is-6-touch {\n flex: none;\n width: 50%; }\n .column.is-offset-6-touch {\n margin-left: 50%; }\n .column.is-7-touch {\n flex: none;\n width: 58.33333%; }\n .column.is-offset-7-touch {\n margin-left: 58.33333%; }\n .column.is-8-touch {\n flex: none;\n width: 66.66667%; }\n .column.is-offset-8-touch {\n margin-left: 66.66667%; }\n .column.is-9-touch {\n flex: none;\n width: 75%; }\n .column.is-offset-9-touch {\n margin-left: 75%; }\n .column.is-10-touch {\n flex: none;\n width: 83.33333%; }\n .column.is-offset-10-touch {\n margin-left: 83.33333%; }\n .column.is-11-touch {\n flex: none;\n width: 91.66667%; }\n .column.is-offset-11-touch {\n margin-left: 91.66667%; }\n .column.is-12-touch {\n flex: none;\n width: 100%; }\n .column.is-offset-12-touch {\n margin-left: 100%; } }\n @media screen and (min-width: 1024px) {\n .column.is-narrow-desktop {\n flex: none;\n width: unset; }\n .column.is-full-desktop {\n flex: none;\n width: 100%; }\n .column.is-three-quarters-desktop {\n flex: none;\n width: 75%; }\n .column.is-two-thirds-desktop {\n flex: none;\n width: 66.6666%; }\n .column.is-half-desktop {\n flex: none;\n width: 50%; }\n .column.is-one-third-desktop {\n flex: none;\n width: 33.3333%; }\n .column.is-one-quarter-desktop {\n flex: none;\n width: 25%; }\n .column.is-one-fifth-desktop {\n flex: none;\n width: 20%; }\n .column.is-two-fifths-desktop {\n flex: none;\n width: 40%; }\n .column.is-three-fifths-desktop {\n flex: none;\n width: 60%; }\n .column.is-four-fifths-desktop {\n flex: none;\n width: 80%; }\n .column.is-offset-three-quarters-desktop {\n margin-left: 75%; }\n .column.is-offset-two-thirds-desktop {\n margin-left: 66.6666%; }\n .column.is-offset-half-desktop {\n margin-left: 50%; }\n .column.is-offset-one-third-desktop {\n margin-left: 33.3333%; }\n .column.is-offset-one-quarter-desktop {\n margin-left: 25%; }\n .column.is-offset-one-fifth-desktop {\n margin-left: 20%; }\n .column.is-offset-two-fifths-desktop {\n margin-left: 40%; }\n .column.is-offset-three-fifths-desktop {\n margin-left: 60%; }\n .column.is-offset-four-fifths-desktop {\n margin-left: 80%; }\n .column.is-0-desktop {\n flex: none;\n width: 0%; }\n .column.is-offset-0-desktop {\n margin-left: 0%; }\n .column.is-1-desktop {\n flex: none;\n width: 8.33333%; }\n .column.is-offset-1-desktop {\n margin-left: 8.33333%; }\n .column.is-2-desktop {\n flex: none;\n width: 16.66667%; }\n .column.is-offset-2-desktop {\n margin-left: 16.66667%; }\n .column.is-3-desktop {\n flex: none;\n width: 25%; }\n .column.is-offset-3-desktop {\n margin-left: 25%; }\n .column.is-4-desktop {\n flex: none;\n width: 33.33333%; }\n .column.is-offset-4-desktop {\n margin-left: 33.33333%; }\n .column.is-5-desktop {\n flex: none;\n width: 41.66667%; }\n .column.is-offset-5-desktop {\n margin-left: 41.66667%; }\n .column.is-6-desktop {\n flex: none;\n width: 50%; }\n .column.is-offset-6-desktop {\n margin-left: 50%; }\n .column.is-7-desktop {\n flex: none;\n width: 58.33333%; }\n .column.is-offset-7-desktop {\n margin-left: 58.33333%; }\n .column.is-8-desktop {\n flex: none;\n width: 66.66667%; }\n .column.is-offset-8-desktop {\n margin-left: 66.66667%; }\n .column.is-9-desktop {\n flex: none;\n width: 75%; }\n .column.is-offset-9-desktop {\n margin-left: 75%; }\n .column.is-10-desktop {\n flex: none;\n width: 83.33333%; }\n .column.is-offset-10-desktop {\n margin-left: 83.33333%; }\n .column.is-11-desktop {\n flex: none;\n width: 91.66667%; }\n .column.is-offset-11-desktop {\n margin-left: 91.66667%; }\n .column.is-12-desktop {\n flex: none;\n width: 100%; }\n .column.is-offset-12-desktop {\n margin-left: 100%; } }\n @media screen and (min-width: 1216px) {\n .column.is-narrow-widescreen {\n flex: none;\n width: unset; }\n .column.is-full-widescreen {\n flex: none;\n width: 100%; }\n .column.is-three-quarters-widescreen {\n flex: none;\n width: 75%; }\n .column.is-two-thirds-widescreen {\n flex: none;\n width: 66.6666%; }\n .column.is-half-widescreen {\n flex: none;\n width: 50%; }\n .column.is-one-third-widescreen {\n flex: none;\n width: 33.3333%; }\n .column.is-one-quarter-widescreen {\n flex: none;\n width: 25%; }\n .column.is-one-fifth-widescreen {\n flex: none;\n width: 20%; }\n .column.is-two-fifths-widescreen {\n flex: none;\n width: 40%; }\n .column.is-three-fifths-widescreen {\n flex: none;\n width: 60%; }\n .column.is-four-fifths-widescreen {\n flex: none;\n width: 80%; }\n .column.is-offset-three-quarters-widescreen {\n margin-left: 75%; }\n .column.is-offset-two-thirds-widescreen {\n margin-left: 66.6666%; }\n .column.is-offset-half-widescreen {\n margin-left: 50%; }\n .column.is-offset-one-third-widescreen {\n margin-left: 33.3333%; }\n .column.is-offset-one-quarter-widescreen {\n margin-left: 25%; }\n .column.is-offset-one-fifth-widescreen {\n margin-left: 20%; }\n .column.is-offset-two-fifths-widescreen {\n margin-left: 40%; }\n .column.is-offset-three-fifths-widescreen {\n margin-left: 60%; }\n .column.is-offset-four-fifths-widescreen {\n margin-left: 80%; }\n .column.is-0-widescreen {\n flex: none;\n width: 0%; }\n .column.is-offset-0-widescreen {\n margin-left: 0%; }\n .column.is-1-widescreen {\n flex: none;\n width: 8.33333%; }\n .column.is-offset-1-widescreen {\n margin-left: 8.33333%; }\n .column.is-2-widescreen {\n flex: none;\n width: 16.66667%; }\n .column.is-offset-2-widescreen {\n margin-left: 16.66667%; }\n .column.is-3-widescreen {\n flex: none;\n width: 25%; }\n .column.is-offset-3-widescreen {\n margin-left: 25%; }\n .column.is-4-widescreen {\n flex: none;\n width: 33.33333%; }\n .column.is-offset-4-widescreen {\n margin-left: 33.33333%; }\n .column.is-5-widescreen {\n flex: none;\n width: 41.66667%; }\n .column.is-offset-5-widescreen {\n margin-left: 41.66667%; }\n .column.is-6-widescreen {\n flex: none;\n width: 50%; }\n .column.is-offset-6-widescreen {\n margin-left: 50%; }\n .column.is-7-widescreen {\n flex: none;\n width: 58.33333%; }\n .column.is-offset-7-widescreen {\n margin-left: 58.33333%; }\n .column.is-8-widescreen {\n flex: none;\n width: 66.66667%; }\n .column.is-offset-8-widescreen {\n margin-left: 66.66667%; }\n .column.is-9-widescreen {\n flex: none;\n width: 75%; }\n .column.is-offset-9-widescreen {\n margin-left: 75%; }\n .column.is-10-widescreen {\n flex: none;\n width: 83.33333%; }\n .column.is-offset-10-widescreen {\n margin-left: 83.33333%; }\n .column.is-11-widescreen {\n flex: none;\n width: 91.66667%; }\n .column.is-offset-11-widescreen {\n margin-left: 91.66667%; }\n .column.is-12-widescreen {\n flex: none;\n width: 100%; }\n .column.is-offset-12-widescreen {\n margin-left: 100%; } }\n @media screen and (min-width: 1408px) {\n .column.is-narrow-fullhd {\n flex: none;\n width: unset; }\n .column.is-full-fullhd {\n flex: none;\n width: 100%; }\n .column.is-three-quarters-fullhd {\n flex: none;\n width: 75%; }\n .column.is-two-thirds-fullhd {\n flex: none;\n width: 66.6666%; }\n .column.is-half-fullhd {\n flex: none;\n width: 50%; }\n .column.is-one-third-fullhd {\n flex: none;\n width: 33.3333%; }\n .column.is-one-quarter-fullhd {\n flex: none;\n width: 25%; }\n .column.is-one-fifth-fullhd {\n flex: none;\n width: 20%; }\n .column.is-two-fifths-fullhd {\n flex: none;\n width: 40%; }\n .column.is-three-fifths-fullhd {\n flex: none;\n width: 60%; }\n .column.is-four-fifths-fullhd {\n flex: none;\n width: 80%; }\n .column.is-offset-three-quarters-fullhd {\n margin-left: 75%; }\n .column.is-offset-two-thirds-fullhd {\n margin-left: 66.6666%; }\n .column.is-offset-half-fullhd {\n margin-left: 50%; }\n .column.is-offset-one-third-fullhd {\n margin-left: 33.3333%; }\n .column.is-offset-one-quarter-fullhd {\n margin-left: 25%; }\n .column.is-offset-one-fifth-fullhd {\n margin-left: 20%; }\n .column.is-offset-two-fifths-fullhd {\n margin-left: 40%; }\n .column.is-offset-three-fifths-fullhd {\n margin-left: 60%; }\n .column.is-offset-four-fifths-fullhd {\n margin-left: 80%; }\n .column.is-0-fullhd {\n flex: none;\n width: 0%; }\n .column.is-offset-0-fullhd {\n margin-left: 0%; }\n .column.is-1-fullhd {\n flex: none;\n width: 8.33333%; }\n .column.is-offset-1-fullhd {\n margin-left: 8.33333%; }\n .column.is-2-fullhd {\n flex: none;\n width: 16.66667%; }\n .column.is-offset-2-fullhd {\n margin-left: 16.66667%; }\n .column.is-3-fullhd {\n flex: none;\n width: 25%; }\n .column.is-offset-3-fullhd {\n margin-left: 25%; }\n .column.is-4-fullhd {\n flex: none;\n width: 33.33333%; }\n .column.is-offset-4-fullhd {\n margin-left: 33.33333%; }\n .column.is-5-fullhd {\n flex: none;\n width: 41.66667%; }\n .column.is-offset-5-fullhd {\n margin-left: 41.66667%; }\n .column.is-6-fullhd {\n flex: none;\n width: 50%; }\n .column.is-offset-6-fullhd {\n margin-left: 50%; }\n .column.is-7-fullhd {\n flex: none;\n width: 58.33333%; }\n .column.is-offset-7-fullhd {\n margin-left: 58.33333%; }\n .column.is-8-fullhd {\n flex: none;\n width: 66.66667%; }\n .column.is-offset-8-fullhd {\n margin-left: 66.66667%; }\n .column.is-9-fullhd {\n flex: none;\n width: 75%; }\n .column.is-offset-9-fullhd {\n margin-left: 75%; }\n .column.is-10-fullhd {\n flex: none;\n width: 83.33333%; }\n .column.is-offset-10-fullhd {\n margin-left: 83.33333%; }\n .column.is-11-fullhd {\n flex: none;\n width: 91.66667%; }\n .column.is-offset-11-fullhd {\n margin-left: 91.66667%; }\n .column.is-12-fullhd {\n flex: none;\n width: 100%; }\n .column.is-offset-12-fullhd {\n margin-left: 100%; } }\n.columns {\n margin-left: -0.75rem;\n margin-right: -0.75rem;\n margin-top: -0.75rem; }\n .columns:last-child {\n margin-bottom: -0.75rem; }\n .columns:not(:last-child) {\n margin-bottom: calc(1.5rem - 0.75rem); }\n .columns.is-centered {\n justify-content: center; }\n .columns.is-gapless {\n margin-left: 0;\n margin-right: 0;\n margin-top: 0; }\n .columns.is-gapless > .column {\n margin: 0;\n padding: 0 !important; }\n .columns.is-gapless:not(:last-child) {\n margin-bottom: 1.5rem; }\n .columns.is-gapless:last-child {\n margin-bottom: 0; }\n .columns.is-mobile {\n display: flex; }\n .columns.is-multiline {\n flex-wrap: wrap; }\n .columns.is-vcentered {\n align-items: center; }\n @media screen and (min-width: 769px), print {\n .columns:not(.is-desktop) {\n display: flex; } }\n @media screen and (min-width: 1024px) {\n .columns.is-desktop {\n display: flex; } }\n.columns.is-variable {\n --columnGap: 0.75rem;\n margin-left: calc(-1 * var(--columnGap));\n margin-right: calc(-1 * var(--columnGap)); }\n .columns.is-variable > .column {\n padding-left: var(--columnGap);\n padding-right: var(--columnGap); }\n .columns.is-variable.is-0 {\n --columnGap: 0rem; }\n @media screen and (max-width: 768px) {\n .columns.is-variable.is-0-mobile {\n --columnGap: 0rem; } }\n @media screen and (min-width: 769px), print {\n .columns.is-variable.is-0-tablet {\n --columnGap: 0rem; } }\n @media screen and (min-width: 769px) and (max-width: 1023px) {\n .columns.is-variable.is-0-tablet-only {\n --columnGap: 0rem; } }\n @media screen and (max-width: 1023px) {\n .columns.is-variable.is-0-touch {\n --columnGap: 0rem; } }\n @media screen and (min-width: 1024px) {\n .columns.is-variable.is-0-desktop {\n --columnGap: 0rem; } }\n @media screen and (min-width: 1024px) and (max-width: 1215px) {\n .columns.is-variable.is-0-desktop-only {\n --columnGap: 0rem; } }\n @media screen and (min-width: 1216px) {\n .columns.is-variable.is-0-widescreen {\n --columnGap: 0rem; } }\n @media screen and (min-width: 1216px) and (max-width: 1407px) {\n .columns.is-variable.is-0-widescreen-only {\n --columnGap: 0rem; } }\n @media screen and (min-width: 1408px) {\n .columns.is-variable.is-0-fullhd {\n --columnGap: 0rem; } }\n .columns.is-variable.is-1 {\n --columnGap: 0.25rem; }\n @media screen and (max-width: 768px) {\n .columns.is-variable.is-1-mobile {\n --columnGap: 0.25rem; } }\n @media screen and (min-width: 769px), print {\n .columns.is-variable.is-1-tablet {\n --columnGap: 0.25rem; } }\n @media screen and (min-width: 769px) and (max-width: 1023px) {\n .columns.is-variable.is-1-tablet-only {\n --columnGap: 0.25rem; } }\n @media screen and (max-width: 1023px) {\n .columns.is-variable.is-1-touch {\n --columnGap: 0.25rem; } }\n @media screen and (min-width: 1024px) {\n .columns.is-variable.is-1-desktop {\n --columnGap: 0.25rem; } }\n @media screen and (min-width: 1024px) and (max-width: 1215px) {\n .columns.is-variable.is-1-desktop-only {\n --columnGap: 0.25rem; } }\n @media screen and (min-width: 1216px) {\n .columns.is-variable.is-1-widescreen {\n --columnGap: 0.25rem; } }\n @media screen and (min-width: 1216px) and (max-width: 1407px) {\n .columns.is-variable.is-1-widescreen-only {\n --columnGap: 0.25rem; } }\n @media screen and (min-width: 1408px) {\n .columns.is-variable.is-1-fullhd {\n --columnGap: 0.25rem; } }\n .columns.is-variable.is-2 {\n --columnGap: 0.5rem; }\n @media screen and (max-width: 768px) {\n .columns.is-variable.is-2-mobile {\n --columnGap: 0.5rem; } }\n @media screen and (min-width: 769px), print {\n .columns.is-variable.is-2-tablet {\n --columnGap: 0.5rem; } }\n @media screen and (min-width: 769px) and (max-width: 1023px) {\n .columns.is-variable.is-2-tablet-only {\n --columnGap: 0.5rem; } }\n @media screen and (max-width: 1023px) {\n .columns.is-variable.is-2-touch {\n --columnGap: 0.5rem; } }\n @media screen and (min-width: 1024px) {\n .columns.is-variable.is-2-desktop {\n --columnGap: 0.5rem; } }\n @media screen and (min-width: 1024px) and (max-width: 1215px) {\n .columns.is-variable.is-2-desktop-only {\n --columnGap: 0.5rem; } }\n @media screen and (min-width: 1216px) {\n .columns.is-variable.is-2-widescreen {\n --columnGap: 0.5rem; } }\n @media screen and (min-width: 1216px) and (max-width: 1407px) {\n .columns.is-variable.is-2-widescreen-only {\n --columnGap: 0.5rem; } }\n @media screen and (min-width: 1408px) {\n .columns.is-variable.is-2-fullhd {\n --columnGap: 0.5rem; } }\n .columns.is-variable.is-3 {\n --columnGap: 0.75rem; }\n @media screen and (max-width: 768px) {\n .columns.is-variable.is-3-mobile {\n --columnGap: 0.75rem; } }\n @media screen and (min-width: 769px), print {\n .columns.is-variable.is-3-tablet {\n --columnGap: 0.75rem; } }\n @media screen and (min-width: 769px) and (max-width: 1023px) {\n .columns.is-variable.is-3-tablet-only {\n --columnGap: 0.75rem; } }\n @media screen and (max-width: 1023px) {\n .columns.is-variable.is-3-touch {\n --columnGap: 0.75rem; } }\n @media screen and (min-width: 1024px) {\n .columns.is-variable.is-3-desktop {\n --columnGap: 0.75rem; } }\n @media screen and (min-width: 1024px) and (max-width: 1215px) {\n .columns.is-variable.is-3-desktop-only {\n --columnGap: 0.75rem; } }\n @media screen and (min-width: 1216px) {\n .columns.is-variable.is-3-widescreen {\n --columnGap: 0.75rem; } }\n @media screen and (min-width: 1216px) and (max-width: 1407px) {\n .columns.is-variable.is-3-widescreen-only {\n --columnGap: 0.75rem; } }\n @media screen and (min-width: 1408px) {\n .columns.is-variable.is-3-fullhd {\n --columnGap: 0.75rem; } }\n .columns.is-variable.is-4 {\n --columnGap: 1rem; }\n @media screen and (max-width: 768px) {\n .columns.is-variable.is-4-mobile {\n --columnGap: 1rem; } }\n @media screen and (min-width: 769px), print {\n .columns.is-variable.is-4-tablet {\n --columnGap: 1rem; } }\n @media screen and (min-width: 769px) and (max-width: 1023px) {\n .columns.is-variable.is-4-tablet-only {\n --columnGap: 1rem; } }\n @media screen and (max-width: 1023px) {\n .columns.is-variable.is-4-touch {\n --columnGap: 1rem; } }\n @media screen and (min-width: 1024px) {\n .columns.is-variable.is-4-desktop {\n --columnGap: 1rem; } }\n @media screen and (min-width: 1024px) and (max-width: 1215px) {\n .columns.is-variable.is-4-desktop-only {\n --columnGap: 1rem; } }\n @media screen and (min-width: 1216px) {\n .columns.is-variable.is-4-widescreen {\n --columnGap: 1rem; } }\n @media screen and (min-width: 1216px) and (max-width: 1407px) {\n .columns.is-variable.is-4-widescreen-only {\n --columnGap: 1rem; } }\n @media screen and (min-width: 1408px) {\n .columns.is-variable.is-4-fullhd {\n --columnGap: 1rem; } }\n .columns.is-variable.is-5 {\n --columnGap: 1.25rem; }\n @media screen and (max-width: 768px) {\n .columns.is-variable.is-5-mobile {\n --columnGap: 1.25rem; } }\n @media screen and (min-width: 769px), print {\n .columns.is-variable.is-5-tablet {\n --columnGap: 1.25rem; } }\n @media screen and (min-width: 769px) and (max-width: 1023px) {\n .columns.is-variable.is-5-tablet-only {\n --columnGap: 1.25rem; } }\n @media screen and (max-width: 1023px) {\n .columns.is-variable.is-5-touch {\n --columnGap: 1.25rem; } }\n @media screen and (min-width: 1024px) {\n .columns.is-variable.is-5-desktop {\n --columnGap: 1.25rem; } }\n @media screen and (min-width: 1024px) and (max-width: 1215px) {\n .columns.is-variable.is-5-desktop-only {\n --columnGap: 1.25rem; } }\n @media screen and (min-width: 1216px) {\n .columns.is-variable.is-5-widescreen {\n --columnGap: 1.25rem; } }\n @media screen and (min-width: 1216px) and (max-width: 1407px) {\n .columns.is-variable.is-5-widescreen-only {\n --columnGap: 1.25rem; } }\n @media screen and (min-width: 1408px) {\n .columns.is-variable.is-5-fullhd {\n --columnGap: 1.25rem; } }\n .columns.is-variable.is-6 {\n --columnGap: 1.5rem; }\n @media screen and (max-width: 768px) {\n .columns.is-variable.is-6-mobile {\n --columnGap: 1.5rem; } }\n @media screen and (min-width: 769px), print {\n .columns.is-variable.is-6-tablet {\n --columnGap: 1.5rem; } }\n @media screen and (min-width: 769px) and (max-width: 1023px) {\n .columns.is-variable.is-6-tablet-only {\n --columnGap: 1.5rem; } }\n @media screen and (max-width: 1023px) {\n .columns.is-variable.is-6-touch {\n --columnGap: 1.5rem; } }\n @media screen and (min-width: 1024px) {\n .columns.is-variable.is-6-desktop {\n --columnGap: 1.5rem; } }\n @media screen and (min-width: 1024px) and (max-width: 1215px) {\n .columns.is-variable.is-6-desktop-only {\n --columnGap: 1.5rem; } }\n @media screen and (min-width: 1216px) {\n .columns.is-variable.is-6-widescreen {\n --columnGap: 1.5rem; } }\n @media screen and (min-width: 1216px) and (max-width: 1407px) {\n .columns.is-variable.is-6-widescreen-only {\n --columnGap: 1.5rem; } }\n @media screen and (min-width: 1408px) {\n .columns.is-variable.is-6-fullhd {\n --columnGap: 1.5rem; } }\n .columns.is-variable.is-7 {\n --columnGap: 1.75rem; }\n @media screen and (max-width: 768px) {\n .columns.is-variable.is-7-mobile {\n --columnGap: 1.75rem; } }\n @media screen and (min-width: 769px), print {\n .columns.is-variable.is-7-tablet {\n --columnGap: 1.75rem; } }\n @media screen and (min-width: 769px) and (max-width: 1023px) {\n .columns.is-variable.is-7-tablet-only {\n --columnGap: 1.75rem; } }\n @media screen and (max-width: 1023px) {\n .columns.is-variable.is-7-touch {\n --columnGap: 1.75rem; } }\n @media screen and (min-width: 1024px) {\n .columns.is-variable.is-7-desktop {\n --columnGap: 1.75rem; } }\n @media screen and (min-width: 1024px) and (max-width: 1215px) {\n .columns.is-variable.is-7-desktop-only {\n --columnGap: 1.75rem; } }\n @media screen and (min-width: 1216px) {\n .columns.is-variable.is-7-widescreen {\n --columnGap: 1.75rem; } }\n @media screen and (min-width: 1216px) and (max-width: 1407px) {\n .columns.is-variable.is-7-widescreen-only {\n --columnGap: 1.75rem; } }\n @media screen and (min-width: 1408px) {\n .columns.is-variable.is-7-fullhd {\n --columnGap: 1.75rem; } }\n .columns.is-variable.is-8 {\n --columnGap: 2rem; }\n @media screen and (max-width: 768px) {\n .columns.is-variable.is-8-mobile {\n --columnGap: 2rem; } }\n @media screen and (min-width: 769px), print {\n .columns.is-variable.is-8-tablet {\n --columnGap: 2rem; } }\n @media screen and (min-width: 769px) and (max-width: 1023px) {\n .columns.is-variable.is-8-tablet-only {\n --columnGap: 2rem; } }\n @media screen and (max-width: 1023px) {\n .columns.is-variable.is-8-touch {\n --columnGap: 2rem; } }\n @media screen and (min-width: 1024px) {\n .columns.is-variable.is-8-desktop {\n --columnGap: 2rem; } }\n @media screen and (min-width: 1024px) and (max-width: 1215px) {\n .columns.is-variable.is-8-desktop-only {\n --columnGap: 2rem; } }\n @media screen and (min-width: 1216px) {\n .columns.is-variable.is-8-widescreen {\n --columnGap: 2rem; } }\n @media screen and (min-width: 1216px) and (max-width: 1407px) {\n .columns.is-variable.is-8-widescreen-only {\n --columnGap: 2rem; } }\n @media screen and (min-width: 1408px) {\n .columns.is-variable.is-8-fullhd {\n --columnGap: 2rem; } }\n.tile {\n align-items: stretch;\n display: block;\n flex-basis: 0;\n flex-grow: 1;\n flex-shrink: 1;\n min-height: min-content; }\n .tile.is-ancestor {\n margin-left: -0.75rem;\n margin-right: -0.75rem;\n margin-top: -0.75rem; }\n .tile.is-ancestor:last-child {\n margin-bottom: -0.75rem; }\n .tile.is-ancestor:not(:last-child) {\n margin-bottom: 0.75rem; }\n .tile.is-child {\n margin: 0 !important; }\n .tile.is-parent {\n padding: 0.75rem; }\n .tile.is-vertical {\n flex-direction: column; }\n .tile.is-vertical > .tile.is-child:not(:last-child) {\n margin-bottom: 1.5rem !important; }\n @media screen and (min-width: 769px), print {\n .tile:not(.is-child) {\n display: flex; }\n .tile.is-1 {\n flex: none;\n width: 8.33333%; }\n .tile.is-2 {\n flex: none;\n width: 16.66667%; }\n .tile.is-3 {\n flex: none;\n width: 25%; }\n .tile.is-4 {\n flex: none;\n width: 33.33333%; }\n .tile.is-5 {\n flex: none;\n width: 41.66667%; }\n .tile.is-6 {\n flex: none;\n width: 50%; }\n .tile.is-7 {\n flex: none;\n width: 58.33333%; }\n .tile.is-8 {\n flex: none;\n width: 66.66667%; }\n .tile.is-9 {\n flex: none;\n width: 75%; }\n .tile.is-10 {\n flex: none;\n width: 83.33333%; }\n .tile.is-11 {\n flex: none;\n width: 91.66667%; }\n .tile.is-12 {\n flex: none;\n width: 100%; } }\n/* Bulma Helpers */\n.has-text-white {\n color: white !important; }\n\na.has-text-white:hover, a.has-text-white:focus {\n color: #e6e6e6 !important; }\n\n.has-background-white {\n background-color: white !important; }\n\n.has-text-black {\n color: #0a0a0a !important; }\n\na.has-text-black:hover, a.has-text-black:focus {\n color: black !important; }\n\n.has-background-black {\n background-color: #0a0a0a !important; }\n\n.has-text-light {\n color: whitesmoke !important; }\n\na.has-text-light:hover, a.has-text-light:focus {\n color: #dbdbdb !important; }\n\n.has-background-light {\n background-color: whitesmoke !important; }\n\n.has-text-dark {\n color: #363636 !important; }\n\na.has-text-dark:hover, a.has-text-dark:focus {\n color: #1c1c1c !important; }\n\n.has-background-dark {\n background-color: #363636 !important; }\n\n.has-text-primary {\n color: #ff0d68 !important; }\n\na.has-text-primary:hover, a.has-text-primary:focus {\n color: #d90052 !important; }\n\n.has-background-primary {\n background-color: #ff0d68 !important; }\n\n.has-text-primary-light {\n color: #ffebf2 !important; }\n\na.has-text-primary-light:hover, a.has-text-primary-light:focus {\n color: #ffb8d2 !important; }\n\n.has-background-primary-light {\n background-color: #ffebf2 !important; }\n\n.has-text-primary-dark {\n color: #e60056 !important; }\n\na.has-text-primary-dark:hover, a.has-text-primary-dark:focus {\n color: #ff1a70 !important; }\n\n.has-background-primary-dark {\n background-color: #e60056 !important; }\n\n.has-text-link {\n color: #ff0d68 !important; }\n\na.has-text-link:hover, a.has-text-link:focus {\n color: #d90052 !important; }\n\n.has-background-link {\n background-color: #ff0d68 !important; }\n\n.has-text-link-light {\n color: #ffebf2 !important; }\n\na.has-text-link-light:hover, a.has-text-link-light:focus {\n color: #ffb8d2 !important; }\n\n.has-background-link-light {\n background-color: #ffebf2 !important; }\n\n.has-text-link-dark {\n color: #e60056 !important; }\n\na.has-text-link-dark:hover, a.has-text-link-dark:focus {\n color: #ff1a70 !important; }\n\n.has-background-link-dark {\n background-color: #e60056 !important; }\n\n.has-text-info {\n color: #0092FF !important; }\n\na.has-text-info:hover, a.has-text-info:focus {\n color: #0075cc !important; }\n\n.has-background-info {\n background-color: #0092FF !important; }\n\n.has-text-info-light {\n color: #ebf6ff !important; }\n\na.has-text-info-light:hover, a.has-text-info-light:focus {\n color: #b8e0ff !important; }\n\n.has-background-info-light {\n background-color: #ebf6ff !important; }\n\n.has-text-info-dark {\n color: #0075cc !important; }\n\na.has-text-info-dark:hover, a.has-text-info-dark:focus {\n color: #0092ff !important; }\n\n.has-background-info-dark {\n background-color: #0075cc !important; }\n\n.has-text-success {\n color: #16DB93 !important; }\n\na.has-text-success:hover, a.has-text-success:focus {\n color: #11ad74 !important; }\n\n.has-background-success {\n background-color: #16DB93 !important; }\n\n.has-text-success-light {\n color: #ecfdf7 !important; }\n\na.has-text-success-light:hover, a.has-text-success-light:focus {\n color: #bef8e3 !important; }\n\n.has-background-success-light {\n background-color: #ecfdf7 !important; }\n\n.has-text-success-dark {\n color: #0e865a !important; }\n\na.has-text-success-dark:hover, a.has-text-success-dark:focus {\n color: #12b579 !important; }\n\n.has-background-success-dark {\n background-color: #0e865a !important; }\n\n.has-text-warning {\n color: #FFE900 !important; }\n\na.has-text-warning:hover, a.has-text-warning:focus {\n color: #ccba00 !important; }\n\n.has-background-warning {\n background-color: #FFE900 !important; }\n\n.has-text-warning-light {\n color: #fffdeb !important; }\n\na.has-text-warning-light:hover, a.has-text-warning-light:focus {\n color: #fff9b8 !important; }\n\n.has-background-warning-light {\n background-color: #fffdeb !important; }\n\n.has-text-warning-dark {\n color: #948700 !important; }\n\na.has-text-warning-dark:hover, a.has-text-warning-dark:focus {\n color: #c7b600 !important; }\n\n.has-background-warning-dark {\n background-color: #948700 !important; }\n\n.has-text-danger {\n color: #f14668 !important; }\n\na.has-text-danger:hover, a.has-text-danger:focus {\n color: #ee1742 !important; }\n\n.has-background-danger {\n background-color: #f14668 !important; }\n\n.has-text-danger-light {\n color: #feecf0 !important; }\n\na.has-text-danger-light:hover, a.has-text-danger-light:focus {\n color: #fabdc9 !important; }\n\n.has-background-danger-light {\n background-color: #feecf0 !important; }\n\n.has-text-danger-dark {\n color: #cc0f35 !important; }\n\na.has-text-danger-dark:hover, a.has-text-danger-dark:focus {\n color: #ee2049 !important; }\n\n.has-background-danger-dark {\n background-color: #cc0f35 !important; }\n\n.has-text-black-bis {\n color: #121212 !important; }\n\n.has-background-black-bis {\n background-color: #121212 !important; }\n\n.has-text-black-ter {\n color: #242424 !important; }\n\n.has-background-black-ter {\n background-color: #242424 !important; }\n\n.has-text-grey-darker {\n color: #363636 !important; }\n\n.has-background-grey-darker {\n background-color: #363636 !important; }\n\n.has-text-grey-dark {\n color: #4a4a4a !important; }\n\n.has-background-grey-dark {\n background-color: #4a4a4a !important; }\n\n.has-text-grey {\n color: #7a7a7a !important; }\n\n.has-background-grey {\n background-color: #7a7a7a !important; }\n\n.has-text-grey-light {\n color: #b5b5b5 !important; }\n\n.has-background-grey-light {\n background-color: #b5b5b5 !important; }\n\n.has-text-grey-lighter {\n color: #dbdbdb !important; }\n\n.has-background-grey-lighter {\n background-color: #dbdbdb !important; }\n\n.has-text-white-ter {\n color: whitesmoke !important; }\n\n.has-background-white-ter {\n background-color: whitesmoke !important; }\n\n.has-text-white-bis {\n color: #fafafa !important; }\n\n.has-background-white-bis {\n background-color: #fafafa !important; }\n\n.is-flex-direction-row {\n flex-direction: row !important; }\n\n.is-flex-direction-row-reverse {\n flex-direction: row-reverse !important; }\n\n.is-flex-direction-column {\n flex-direction: column !important; }\n\n.is-flex-direction-column-reverse {\n flex-direction: column-reverse !important; }\n\n.is-flex-wrap-nowrap {\n flex-wrap: nowrap !important; }\n\n.is-flex-wrap-wrap {\n flex-wrap: wrap !important; }\n\n.is-flex-wrap-wrap-reverse {\n flex-wrap: wrap-reverse !important; }\n\n.is-justify-content-flex-start {\n justify-content: flex-start !important; }\n\n.is-justify-content-flex-end {\n justify-content: flex-end !important; }\n\n.is-justify-content-center {\n justify-content: center !important; }\n\n.is-justify-content-space-between {\n justify-content: space-between !important; }\n\n.is-justify-content-space-around {\n justify-content: space-around !important; }\n\n.is-justify-content-space-evenly {\n justify-content: space-evenly !important; }\n\n.is-justify-content-start {\n justify-content: start !important; }\n\n.is-justify-content-end {\n justify-content: end !important; }\n\n.is-justify-content-left {\n justify-content: left !important; }\n\n.is-justify-content-right {\n justify-content: right !important; }\n\n.is-align-content-flex-start {\n align-content: flex-start !important; }\n\n.is-align-content-flex-end {\n align-content: flex-end !important; }\n\n.is-align-content-center {\n align-content: center !important; }\n\n.is-align-content-space-between {\n align-content: space-between !important; }\n\n.is-align-content-space-around {\n align-content: space-around !important; }\n\n.is-align-content-space-evenly {\n align-content: space-evenly !important; }\n\n.is-align-content-stretch {\n align-content: stretch !important; }\n\n.is-align-content-start {\n align-content: start !important; }\n\n.is-align-content-end {\n align-content: end !important; }\n\n.is-align-content-baseline {\n align-content: baseline !important; }\n\n.is-align-items-stretch {\n align-items: stretch !important; }\n\n.is-align-items-flex-start {\n align-items: flex-start !important; }\n\n.is-align-items-flex-end {\n align-items: flex-end !important; }\n\n.is-align-items-center {\n align-items: center !important; }\n\n.is-align-items-baseline {\n align-items: baseline !important; }\n\n.is-align-items-start {\n align-items: start !important; }\n\n.is-align-items-end {\n align-items: end !important; }\n\n.is-align-items-self-start {\n align-items: self-start !important; }\n\n.is-align-items-self-end {\n align-items: self-end !important; }\n\n.is-align-self-auto {\n align-self: auto !important; }\n\n.is-align-self-flex-start {\n align-self: flex-start !important; }\n\n.is-align-self-flex-end {\n align-self: flex-end !important; }\n\n.is-align-self-center {\n align-self: center !important; }\n\n.is-align-self-baseline {\n align-self: baseline !important; }\n\n.is-align-self-stretch {\n align-self: stretch !important; }\n\n.is-flex-grow-0 {\n flex-grow: 0 !important; }\n\n.is-flex-grow-1 {\n flex-grow: 1 !important; }\n\n.is-flex-grow-2 {\n flex-grow: 2 !important; }\n\n.is-flex-grow-3 {\n flex-grow: 3 !important; }\n\n.is-flex-grow-4 {\n flex-grow: 4 !important; }\n\n.is-flex-grow-5 {\n flex-grow: 5 !important; }\n\n.is-flex-shrink-0 {\n flex-shrink: 0 !important; }\n\n.is-flex-shrink-1 {\n flex-shrink: 1 !important; }\n\n.is-flex-shrink-2 {\n flex-shrink: 2 !important; }\n\n.is-flex-shrink-3 {\n flex-shrink: 3 !important; }\n\n.is-flex-shrink-4 {\n flex-shrink: 4 !important; }\n\n.is-flex-shrink-5 {\n flex-shrink: 5 !important; }\n\n.is-clearfix::after {\n clear: both;\n content: \" \";\n display: table; }\n\n.is-pulled-left {\n float: left !important; }\n\n.is-pulled-right {\n float: right !important; }\n\n.is-radiusless {\n border-radius: 0 !important; }\n\n.is-shadowless {\n box-shadow: none !important; }\n\n.is-clickable {\n cursor: pointer !important;\n pointer-events: all !important; }\n\n.is-clipped {\n overflow: hidden !important; }\n\n.is-relative {\n position: relative !important; }\n\n.is-marginless {\n margin: 0 !important; }\n\n.is-paddingless {\n padding: 0 !important; }\n\n.m-0 {\n margin: 0 !important; }\n\n.mt-0 {\n margin-top: 0 !important; }\n\n.mr-0 {\n margin-right: 0 !important; }\n\n.mb-0 {\n margin-bottom: 0 !important; }\n\n.ml-0 {\n margin-left: 0 !important; }\n\n.mx-0 {\n margin-left: 0 !important;\n margin-right: 0 !important; }\n\n.my-0 {\n margin-top: 0 !important;\n margin-bottom: 0 !important; }\n\n.m-1 {\n margin: 0.25rem !important; }\n\n.mt-1 {\n margin-top: 0.25rem !important; }\n\n.mr-1 {\n margin-right: 0.25rem !important; }\n\n.mb-1 {\n margin-bottom: 0.25rem !important; }\n\n.ml-1 {\n margin-left: 0.25rem !important; }\n\n.mx-1 {\n margin-left: 0.25rem !important;\n margin-right: 0.25rem !important; }\n\n.my-1 {\n margin-top: 0.25rem !important;\n margin-bottom: 0.25rem !important; }\n\n.m-2 {\n margin: 0.5rem !important; }\n\n.mt-2 {\n margin-top: 0.5rem !important; }\n\n.mr-2 {\n margin-right: 0.5rem !important; }\n\n.mb-2 {\n margin-bottom: 0.5rem !important; }\n\n.ml-2 {\n margin-left: 0.5rem !important; }\n\n.mx-2 {\n margin-left: 0.5rem !important;\n margin-right: 0.5rem !important; }\n\n.my-2 {\n margin-top: 0.5rem !important;\n margin-bottom: 0.5rem !important; }\n\n.m-3 {\n margin: 0.75rem !important; }\n\n.mt-3 {\n margin-top: 0.75rem !important; }\n\n.mr-3 {\n margin-right: 0.75rem !important; }\n\n.mb-3 {\n margin-bottom: 0.75rem !important; }\n\n.ml-3 {\n margin-left: 0.75rem !important; }\n\n.mx-3 {\n margin-left: 0.75rem !important;\n margin-right: 0.75rem !important; }\n\n.my-3 {\n margin-top: 0.75rem !important;\n margin-bottom: 0.75rem !important; }\n\n.m-4 {\n margin: 1rem !important; }\n\n.mt-4 {\n margin-top: 1rem !important; }\n\n.mr-4 {\n margin-right: 1rem !important; }\n\n.mb-4 {\n margin-bottom: 1rem !important; }\n\n.ml-4 {\n margin-left: 1rem !important; }\n\n.mx-4 {\n margin-left: 1rem !important;\n margin-right: 1rem !important; }\n\n.my-4 {\n margin-top: 1rem !important;\n margin-bottom: 1rem !important; }\n\n.m-5 {\n margin: 1.5rem !important; }\n\n.mt-5 {\n margin-top: 1.5rem !important; }\n\n.mr-5 {\n margin-right: 1.5rem !important; }\n\n.mb-5 {\n margin-bottom: 1.5rem !important; }\n\n.ml-5 {\n margin-left: 1.5rem !important; }\n\n.mx-5 {\n margin-left: 1.5rem !important;\n margin-right: 1.5rem !important; }\n\n.my-5 {\n margin-top: 1.5rem !important;\n margin-bottom: 1.5rem !important; }\n\n.m-6 {\n margin: 3rem !important; }\n\n.mt-6 {\n margin-top: 3rem !important; }\n\n.mr-6 {\n margin-right: 3rem !important; }\n\n.mb-6 {\n margin-bottom: 3rem !important; }\n\n.ml-6 {\n margin-left: 3rem !important; }\n\n.mx-6 {\n margin-left: 3rem !important;\n margin-right: 3rem !important; }\n\n.my-6 {\n margin-top: 3rem !important;\n margin-bottom: 3rem !important; }\n\n.m-auto {\n margin: auto !important; }\n\n.mt-auto {\n margin-top: auto !important; }\n\n.mr-auto {\n margin-right: auto !important; }\n\n.mb-auto {\n margin-bottom: auto !important; }\n\n.ml-auto {\n margin-left: auto !important; }\n\n.mx-auto {\n margin-left: auto !important;\n margin-right: auto !important; }\n\n.my-auto {\n margin-top: auto !important;\n margin-bottom: auto !important; }\n\n.p-0 {\n padding: 0 !important; }\n\n.pt-0 {\n padding-top: 0 !important; }\n\n.pr-0 {\n padding-right: 0 !important; }\n\n.pb-0 {\n padding-bottom: 0 !important; }\n\n.pl-0 {\n padding-left: 0 !important; }\n\n.px-0 {\n padding-left: 0 !important;\n padding-right: 0 !important; }\n\n.py-0 {\n padding-top: 0 !important;\n padding-bottom: 0 !important; }\n\n.p-1 {\n padding: 0.25rem !important; }\n\n.pt-1 {\n padding-top: 0.25rem !important; }\n\n.pr-1 {\n padding-right: 0.25rem !important; }\n\n.pb-1 {\n padding-bottom: 0.25rem !important; }\n\n.pl-1 {\n padding-left: 0.25rem !important; }\n\n.px-1 {\n padding-left: 0.25rem !important;\n padding-right: 0.25rem !important; }\n\n.py-1 {\n padding-top: 0.25rem !important;\n padding-bottom: 0.25rem !important; }\n\n.p-2 {\n padding: 0.5rem !important; }\n\n.pt-2 {\n padding-top: 0.5rem !important; }\n\n.pr-2 {\n padding-right: 0.5rem !important; }\n\n.pb-2 {\n padding-bottom: 0.5rem !important; }\n\n.pl-2 {\n padding-left: 0.5rem !important; }\n\n.px-2 {\n padding-left: 0.5rem !important;\n padding-right: 0.5rem !important; }\n\n.py-2 {\n padding-top: 0.5rem !important;\n padding-bottom: 0.5rem !important; }\n\n.p-3 {\n padding: 0.75rem !important; }\n\n.pt-3 {\n padding-top: 0.75rem !important; }\n\n.pr-3 {\n padding-right: 0.75rem !important; }\n\n.pb-3 {\n padding-bottom: 0.75rem !important; }\n\n.pl-3 {\n padding-left: 0.75rem !important; }\n\n.px-3 {\n padding-left: 0.75rem !important;\n padding-right: 0.75rem !important; }\n\n.py-3 {\n padding-top: 0.75rem !important;\n padding-bottom: 0.75rem !important; }\n\n.p-4 {\n padding: 1rem !important; }\n\n.pt-4 {\n padding-top: 1rem !important; }\n\n.pr-4 {\n padding-right: 1rem !important; }\n\n.pb-4 {\n padding-bottom: 1rem !important; }\n\n.pl-4 {\n padding-left: 1rem !important; }\n\n.px-4 {\n padding-left: 1rem !important;\n padding-right: 1rem !important; }\n\n.py-4 {\n padding-top: 1rem !important;\n padding-bottom: 1rem !important; }\n\n.p-5 {\n padding: 1.5rem !important; }\n\n.pt-5 {\n padding-top: 1.5rem !important; }\n\n.pr-5 {\n padding-right: 1.5rem !important; }\n\n.pb-5 {\n padding-bottom: 1.5rem !important; }\n\n.pl-5 {\n padding-left: 1.5rem !important; }\n\n.px-5 {\n padding-left: 1.5rem !important;\n padding-right: 1.5rem !important; }\n\n.py-5 {\n padding-top: 1.5rem !important;\n padding-bottom: 1.5rem !important; }\n\n.p-6 {\n padding: 3rem !important; }\n\n.pt-6 {\n padding-top: 3rem !important; }\n\n.pr-6 {\n padding-right: 3rem !important; }\n\n.pb-6 {\n padding-bottom: 3rem !important; }\n\n.pl-6 {\n padding-left: 3rem !important; }\n\n.px-6 {\n padding-left: 3rem !important;\n padding-right: 3rem !important; }\n\n.py-6 {\n padding-top: 3rem !important;\n padding-bottom: 3rem !important; }\n\n.p-auto {\n padding: auto !important; }\n\n.pt-auto {\n padding-top: auto !important; }\n\n.pr-auto {\n padding-right: auto !important; }\n\n.pb-auto {\n padding-bottom: auto !important; }\n\n.pl-auto {\n padding-left: auto !important; }\n\n.px-auto {\n padding-left: auto !important;\n padding-right: auto !important; }\n\n.py-auto {\n padding-top: auto !important;\n padding-bottom: auto !important; }\n\n.is-size-1 {\n font-size: 3rem !important; }\n\n.is-size-2 {\n font-size: 2.5rem !important; }\n\n.is-size-3 {\n font-size: 2rem !important; }\n\n.is-size-4 {\n font-size: 1.5rem !important; }\n\n.is-size-5 {\n font-size: 1.25rem !important; }\n\n.is-size-6 {\n font-size: 1rem !important; }\n\n.is-size-7 {\n font-size: 0.75rem !important; }\n\n@media screen and (max-width: 768px) {\n .is-size-1-mobile {\n font-size: 3rem !important; }\n .is-size-2-mobile {\n font-size: 2.5rem !important; }\n .is-size-3-mobile {\n font-size: 2rem !important; }\n .is-size-4-mobile {\n font-size: 1.5rem !important; }\n .is-size-5-mobile {\n font-size: 1.25rem !important; }\n .is-size-6-mobile {\n font-size: 1rem !important; }\n .is-size-7-mobile {\n font-size: 0.75rem !important; } }\n\n@media screen and (min-width: 769px), print {\n .is-size-1-tablet {\n font-size: 3rem !important; }\n .is-size-2-tablet {\n font-size: 2.5rem !important; }\n .is-size-3-tablet {\n font-size: 2rem !important; }\n .is-size-4-tablet {\n font-size: 1.5rem !important; }\n .is-size-5-tablet {\n font-size: 1.25rem !important; }\n .is-size-6-tablet {\n font-size: 1rem !important; }\n .is-size-7-tablet {\n font-size: 0.75rem !important; } }\n\n@media screen and (max-width: 1023px) {\n .is-size-1-touch {\n font-size: 3rem !important; }\n .is-size-2-touch {\n font-size: 2.5rem !important; }\n .is-size-3-touch {\n font-size: 2rem !important; }\n .is-size-4-touch {\n font-size: 1.5rem !important; }\n .is-size-5-touch {\n font-size: 1.25rem !important; }\n .is-size-6-touch {\n font-size: 1rem !important; }\n .is-size-7-touch {\n font-size: 0.75rem !important; } }\n\n@media screen and (min-width: 1024px) {\n .is-size-1-desktop {\n font-size: 3rem !important; }\n .is-size-2-desktop {\n font-size: 2.5rem !important; }\n .is-size-3-desktop {\n font-size: 2rem !important; }\n .is-size-4-desktop {\n font-size: 1.5rem !important; }\n .is-size-5-desktop {\n font-size: 1.25rem !important; }\n .is-size-6-desktop {\n font-size: 1rem !important; }\n .is-size-7-desktop {\n font-size: 0.75rem !important; } }\n\n@media screen and (min-width: 1216px) {\n .is-size-1-widescreen {\n font-size: 3rem !important; }\n .is-size-2-widescreen {\n font-size: 2.5rem !important; }\n .is-size-3-widescreen {\n font-size: 2rem !important; }\n .is-size-4-widescreen {\n font-size: 1.5rem !important; }\n .is-size-5-widescreen {\n font-size: 1.25rem !important; }\n .is-size-6-widescreen {\n font-size: 1rem !important; }\n .is-size-7-widescreen {\n font-size: 0.75rem !important; } }\n\n@media screen and (min-width: 1408px) {\n .is-size-1-fullhd {\n font-size: 3rem !important; }\n .is-size-2-fullhd {\n font-size: 2.5rem !important; }\n .is-size-3-fullhd {\n font-size: 2rem !important; }\n .is-size-4-fullhd {\n font-size: 1.5rem !important; }\n .is-size-5-fullhd {\n font-size: 1.25rem !important; }\n .is-size-6-fullhd {\n font-size: 1rem !important; }\n .is-size-7-fullhd {\n font-size: 0.75rem !important; } }\n\n.has-text-centered {\n text-align: center !important; }\n\n.has-text-justified {\n text-align: justify !important; }\n\n.has-text-left {\n text-align: left !important; }\n\n.has-text-right {\n text-align: right !important; }\n\n@media screen and (max-width: 768px) {\n .has-text-centered-mobile {\n text-align: center !important; } }\n\n@media screen and (min-width: 769px), print {\n .has-text-centered-tablet {\n text-align: center !important; } }\n\n@media screen and (min-width: 769px) and (max-width: 1023px) {\n .has-text-centered-tablet-only {\n text-align: center !important; } }\n\n@media screen and (max-width: 1023px) {\n .has-text-centered-touch {\n text-align: center !important; } }\n\n@media screen and (min-width: 1024px) {\n .has-text-centered-desktop {\n text-align: center !important; } }\n\n@media screen and (min-width: 1024px) and (max-width: 1215px) {\n .has-text-centered-desktop-only {\n text-align: center !important; } }\n\n@media screen and (min-width: 1216px) {\n .has-text-centered-widescreen {\n text-align: center !important; } }\n\n@media screen and (min-width: 1216px) and (max-width: 1407px) {\n .has-text-centered-widescreen-only {\n text-align: center !important; } }\n\n@media screen and (min-width: 1408px) {\n .has-text-centered-fullhd {\n text-align: center !important; } }\n\n@media screen and (max-width: 768px) {\n .has-text-justified-mobile {\n text-align: justify !important; } }\n\n@media screen and (min-width: 769px), print {\n .has-text-justified-tablet {\n text-align: justify !important; } }\n\n@media screen and (min-width: 769px) and (max-width: 1023px) {\n .has-text-justified-tablet-only {\n text-align: justify !important; } }\n\n@media screen and (max-width: 1023px) {\n .has-text-justified-touch {\n text-align: justify !important; } }\n\n@media screen and (min-width: 1024px) {\n .has-text-justified-desktop {\n text-align: justify !important; } }\n\n@media screen and (min-width: 1024px) and (max-width: 1215px) {\n .has-text-justified-desktop-only {\n text-align: justify !important; } }\n\n@media screen and (min-width: 1216px) {\n .has-text-justified-widescreen {\n text-align: justify !important; } }\n\n@media screen and (min-width: 1216px) and (max-width: 1407px) {\n .has-text-justified-widescreen-only {\n text-align: justify !important; } }\n\n@media screen and (min-width: 1408px) {\n .has-text-justified-fullhd {\n text-align: justify !important; } }\n\n@media screen and (max-width: 768px) {\n .has-text-left-mobile {\n text-align: left !important; } }\n\n@media screen and (min-width: 769px), print {\n .has-text-left-tablet {\n text-align: left !important; } }\n\n@media screen and (min-width: 769px) and (max-width: 1023px) {\n .has-text-left-tablet-only {\n text-align: left !important; } }\n\n@media screen and (max-width: 1023px) {\n .has-text-left-touch {\n text-align: left !important; } }\n\n@media screen and (min-width: 1024px) {\n .has-text-left-desktop {\n text-align: left !important; } }\n\n@media screen and (min-width: 1024px) and (max-width: 1215px) {\n .has-text-left-desktop-only {\n text-align: left !important; } }\n\n@media screen and (min-width: 1216px) {\n .has-text-left-widescreen {\n text-align: left !important; } }\n\n@media screen and (min-width: 1216px) and (max-width: 1407px) {\n .has-text-left-widescreen-only {\n text-align: left !important; } }\n\n@media screen and (min-width: 1408px) {\n .has-text-left-fullhd {\n text-align: left !important; } }\n\n@media screen and (max-width: 768px) {\n .has-text-right-mobile {\n text-align: right !important; } }\n\n@media screen and (min-width: 769px), print {\n .has-text-right-tablet {\n text-align: right !important; } }\n\n@media screen and (min-width: 769px) and (max-width: 1023px) {\n .has-text-right-tablet-only {\n text-align: right !important; } }\n\n@media screen and (max-width: 1023px) {\n .has-text-right-touch {\n text-align: right !important; } }\n\n@media screen and (min-width: 1024px) {\n .has-text-right-desktop {\n text-align: right !important; } }\n\n@media screen and (min-width: 1024px) and (max-width: 1215px) {\n .has-text-right-desktop-only {\n text-align: right !important; } }\n\n@media screen and (min-width: 1216px) {\n .has-text-right-widescreen {\n text-align: right !important; } }\n\n@media screen and (min-width: 1216px) and (max-width: 1407px) {\n .has-text-right-widescreen-only {\n text-align: right !important; } }\n\n@media screen and (min-width: 1408px) {\n .has-text-right-fullhd {\n text-align: right !important; } }\n\n.is-capitalized {\n text-transform: capitalize !important; }\n\n.is-lowercase {\n text-transform: lowercase !important; }\n\n.is-uppercase {\n text-transform: uppercase !important; }\n\n.is-italic {\n font-style: italic !important; }\n\n.is-underlined {\n text-decoration: underline !important; }\n\n.has-text-weight-light {\n font-weight: 300 !important; }\n\n.has-text-weight-normal {\n font-weight: 400 !important; }\n\n.has-text-weight-medium {\n font-weight: 500 !important; }\n\n.has-text-weight-semibold {\n font-weight: 600 !important; }\n\n.has-text-weight-bold {\n font-weight: 700 !important; }\n\n.is-family-primary {\n font-family: BlinkMacSystemFont, -apple-system, \"Segoe UI\", \"Roboto\", \"Oxygen\", \"Ubuntu\", \"Cantarell\", \"Fira Sans\", \"Droid Sans\", \"Helvetica Neue\", \"Helvetica\", \"Arial\", sans-serif !important; }\n\n.is-family-secondary {\n font-family: BlinkMacSystemFont, -apple-system, \"Segoe UI\", \"Roboto\", \"Oxygen\", \"Ubuntu\", \"Cantarell\", \"Fira Sans\", \"Droid Sans\", \"Helvetica Neue\", \"Helvetica\", \"Arial\", sans-serif !important; }\n\n.is-family-sans-serif {\n font-family: BlinkMacSystemFont, -apple-system, \"Segoe UI\", \"Roboto\", \"Oxygen\", \"Ubuntu\", \"Cantarell\", \"Fira Sans\", \"Droid Sans\", \"Helvetica Neue\", \"Helvetica\", \"Arial\", sans-serif !important; }\n\n.is-family-monospace {\n font-family: monospace !important; }\n\n.is-family-code {\n font-family: monospace !important; }\n\n.is-block {\n display: block !important; }\n\n@media screen and (max-width: 768px) {\n .is-block-mobile {\n display: block !important; } }\n\n@media screen and (min-width: 769px), print {\n .is-block-tablet {\n display: block !important; } }\n\n@media screen and (min-width: 769px) and (max-width: 1023px) {\n .is-block-tablet-only {\n display: block !important; } }\n\n@media screen and (max-width: 1023px) {\n .is-block-touch {\n display: block !important; } }\n\n@media screen and (min-width: 1024px) {\n .is-block-desktop {\n display: block !important; } }\n\n@media screen and (min-width: 1024px) and (max-width: 1215px) {\n .is-block-desktop-only {\n display: block !important; } }\n\n@media screen and (min-width: 1216px) {\n .is-block-widescreen {\n display: block !important; } }\n\n@media screen and (min-width: 1216px) and (max-width: 1407px) {\n .is-block-widescreen-only {\n display: block !important; } }\n\n@media screen and (min-width: 1408px) {\n .is-block-fullhd {\n display: block !important; } }\n\n.is-flex {\n display: flex !important; }\n\n@media screen and (max-width: 768px) {\n .is-flex-mobile {\n display: flex !important; } }\n\n@media screen and (min-width: 769px), print {\n .is-flex-tablet {\n display: flex !important; } }\n\n@media screen and (min-width: 769px) and (max-width: 1023px) {\n .is-flex-tablet-only {\n display: flex !important; } }\n\n@media screen and (max-width: 1023px) {\n .is-flex-touch {\n display: flex !important; } }\n\n@media screen and (min-width: 1024px) {\n .is-flex-desktop {\n display: flex !important; } }\n\n@media screen and (min-width: 1024px) and (max-width: 1215px) {\n .is-flex-desktop-only {\n display: flex !important; } }\n\n@media screen and (min-width: 1216px) {\n .is-flex-widescreen {\n display: flex !important; } }\n\n@media screen and (min-width: 1216px) and (max-width: 1407px) {\n .is-flex-widescreen-only {\n display: flex !important; } }\n\n@media screen and (min-width: 1408px) {\n .is-flex-fullhd {\n display: flex !important; } }\n\n.is-inline {\n display: inline !important; }\n\n@media screen and (max-width: 768px) {\n .is-inline-mobile {\n display: inline !important; } }\n\n@media screen and (min-width: 769px), print {\n .is-inline-tablet {\n display: inline !important; } }\n\n@media screen and (min-width: 769px) and (max-width: 1023px) {\n .is-inline-tablet-only {\n display: inline !important; } }\n\n@media screen and (max-width: 1023px) {\n .is-inline-touch {\n display: inline !important; } }\n\n@media screen and (min-width: 1024px) {\n .is-inline-desktop {\n display: inline !important; } }\n\n@media screen and (min-width: 1024px) and (max-width: 1215px) {\n .is-inline-desktop-only {\n display: inline !important; } }\n\n@media screen and (min-width: 1216px) {\n .is-inline-widescreen {\n display: inline !important; } }\n\n@media screen and (min-width: 1216px) and (max-width: 1407px) {\n .is-inline-widescreen-only {\n display: inline !important; } }\n\n@media screen and (min-width: 1408px) {\n .is-inline-fullhd {\n display: inline !important; } }\n\n.is-inline-block {\n display: inline-block !important; }\n\n@media screen and (max-width: 768px) {\n .is-inline-block-mobile {\n display: inline-block !important; } }\n\n@media screen and (min-width: 769px), print {\n .is-inline-block-tablet {\n display: inline-block !important; } }\n\n@media screen and (min-width: 769px) and (max-width: 1023px) {\n .is-inline-block-tablet-only {\n display: inline-block !important; } }\n\n@media screen and (max-width: 1023px) {\n .is-inline-block-touch {\n display: inline-block !important; } }\n\n@media screen and (min-width: 1024px) {\n .is-inline-block-desktop {\n display: inline-block !important; } }\n\n@media screen and (min-width: 1024px) and (max-width: 1215px) {\n .is-inline-block-desktop-only {\n display: inline-block !important; } }\n\n@media screen and (min-width: 1216px) {\n .is-inline-block-widescreen {\n display: inline-block !important; } }\n\n@media screen and (min-width: 1216px) and (max-width: 1407px) {\n .is-inline-block-widescreen-only {\n display: inline-block !important; } }\n\n@media screen and (min-width: 1408px) {\n .is-inline-block-fullhd {\n display: inline-block !important; } }\n\n.is-inline-flex {\n display: inline-flex !important; }\n\n@media screen and (max-width: 768px) {\n .is-inline-flex-mobile {\n display: inline-flex !important; } }\n\n@media screen and (min-width: 769px), print {\n .is-inline-flex-tablet {\n display: inline-flex !important; } }\n\n@media screen and (min-width: 769px) and (max-width: 1023px) {\n .is-inline-flex-tablet-only {\n display: inline-flex !important; } }\n\n@media screen and (max-width: 1023px) {\n .is-inline-flex-touch {\n display: inline-flex !important; } }\n\n@media screen and (min-width: 1024px) {\n .is-inline-flex-desktop {\n display: inline-flex !important; } }\n\n@media screen and (min-width: 1024px) and (max-width: 1215px) {\n .is-inline-flex-desktop-only {\n display: inline-flex !important; } }\n\n@media screen and (min-width: 1216px) {\n .is-inline-flex-widescreen {\n display: inline-flex !important; } }\n\n@media screen and (min-width: 1216px) and (max-width: 1407px) {\n .is-inline-flex-widescreen-only {\n display: inline-flex !important; } }\n\n@media screen and (min-width: 1408px) {\n .is-inline-flex-fullhd {\n display: inline-flex !important; } }\n\n.is-hidden {\n display: none !important; }\n\n.is-sr-only {\n border: none !important;\n clip: rect(0, 0, 0, 0) !important;\n height: 0.01em !important;\n overflow: hidden !important;\n padding: 0 !important;\n position: absolute !important;\n white-space: nowrap !important;\n width: 0.01em !important; }\n\n@media screen and (max-width: 768px) {\n .is-hidden-mobile {\n display: none !important; } }\n\n@media screen and (min-width: 769px), print {\n .is-hidden-tablet {\n display: none !important; } }\n\n@media screen and (min-width: 769px) and (max-width: 1023px) {\n .is-hidden-tablet-only {\n display: none !important; } }\n\n@media screen and (max-width: 1023px) {\n .is-hidden-touch {\n display: none !important; } }\n\n@media screen and (min-width: 1024px) {\n .is-hidden-desktop {\n display: none !important; } }\n\n@media screen and (min-width: 1024px) and (max-width: 1215px) {\n .is-hidden-desktop-only {\n display: none !important; } }\n\n@media screen and (min-width: 1216px) {\n .is-hidden-widescreen {\n display: none !important; } }\n\n@media screen and (min-width: 1216px) and (max-width: 1407px) {\n .is-hidden-widescreen-only {\n display: none !important; } }\n\n@media screen and (min-width: 1408px) {\n .is-hidden-fullhd {\n display: none !important; } }\n\n.is-invisible {\n visibility: hidden !important; }\n\n@media screen and (max-width: 768px) {\n .is-invisible-mobile {\n visibility: hidden !important; } }\n\n@media screen and (min-width: 769px), print {\n .is-invisible-tablet {\n visibility: hidden !important; } }\n\n@media screen and (min-width: 769px) and (max-width: 1023px) {\n .is-invisible-tablet-only {\n visibility: hidden !important; } }\n\n@media screen and (max-width: 1023px) {\n .is-invisible-touch {\n visibility: hidden !important; } }\n\n@media screen and (min-width: 1024px) {\n .is-invisible-desktop {\n visibility: hidden !important; } }\n\n@media screen and (min-width: 1024px) and (max-width: 1215px) {\n .is-invisible-desktop-only {\n visibility: hidden !important; } }\n\n@media screen and (min-width: 1216px) {\n .is-invisible-widescreen {\n visibility: hidden !important; } }\n\n@media screen and (min-width: 1216px) and (max-width: 1407px) {\n .is-invisible-widescreen-only {\n visibility: hidden !important; } }\n\n@media screen and (min-width: 1408px) {\n .is-invisible-fullhd {\n visibility: hidden !important; } }\n\n/* Bulma Layout */\n.hero {\n align-items: stretch;\n display: flex;\n flex-direction: column;\n justify-content: space-between; }\n .hero .navbar {\n background: none; }\n .hero .tabs ul {\n border-bottom: none; }\n .hero.is-white {\n background-color: white;\n color: #0a0a0a; }\n .hero.is-white a:not(.button):not(.dropdown-item):not(.tag):not(.pagination-link.is-current),\n .hero.is-white strong {\n color: inherit; }\n .hero.is-white .title {\n color: #0a0a0a; }\n .hero.is-white .subtitle {\n color: rgba(10, 10, 10, 0.9); }\n .hero.is-white .subtitle a:not(.button),\n .hero.is-white .subtitle strong {\n color: #0a0a0a; }\n @media screen and (max-width: 1023px) {\n .hero.is-white .navbar-menu {\n background-color: white; } }\n .hero.is-white .navbar-item,\n .hero.is-white .navbar-link {\n color: rgba(10, 10, 10, 0.7); }\n .hero.is-white a.navbar-item:hover, .hero.is-white a.navbar-item.is-active,\n .hero.is-white .navbar-link:hover,\n .hero.is-white .navbar-link.is-active {\n background-color: #f2f2f2;\n color: #0a0a0a; }\n .hero.is-white .tabs a {\n color: #0a0a0a;\n opacity: 0.9; }\n .hero.is-white .tabs a:hover {\n opacity: 1; }\n .hero.is-white .tabs li.is-active a {\n color: white !important;\n opacity: 1; }\n .hero.is-white .tabs.is-boxed a, .hero.is-white .tabs.is-toggle a {\n color: #0a0a0a; }\n .hero.is-white .tabs.is-boxed a:hover, .hero.is-white .tabs.is-toggle a:hover {\n background-color: rgba(10, 10, 10, 0.1); }\n .hero.is-white .tabs.is-boxed li.is-active a, .hero.is-white .tabs.is-boxed li.is-active a:hover, .hero.is-white .tabs.is-toggle li.is-active a, .hero.is-white .tabs.is-toggle li.is-active a:hover {\n background-color: #0a0a0a;\n border-color: #0a0a0a;\n color: white; }\n .hero.is-white.is-bold {\n background-image: linear-gradient(141deg, #e8e3e4 0%, white 71%, white 100%); }\n @media screen and (max-width: 768px) {\n .hero.is-white.is-bold .navbar-menu {\n background-image: linear-gradient(141deg, #e8e3e4 0%, white 71%, white 100%); } }\n .hero.is-black {\n background-color: #0a0a0a;\n color: white; }\n .hero.is-black a:not(.button):not(.dropdown-item):not(.tag):not(.pagination-link.is-current),\n .hero.is-black strong {\n color: inherit; }\n .hero.is-black .title {\n color: white; }\n .hero.is-black .subtitle {\n color: rgba(255, 255, 255, 0.9); }\n .hero.is-black .subtitle a:not(.button),\n .hero.is-black .subtitle strong {\n color: white; }\n @media screen and (max-width: 1023px) {\n .hero.is-black .navbar-menu {\n background-color: #0a0a0a; } }\n .hero.is-black .navbar-item,\n .hero.is-black .navbar-link {\n color: rgba(255, 255, 255, 0.7); }\n .hero.is-black a.navbar-item:hover, .hero.is-black a.navbar-item.is-active,\n .hero.is-black .navbar-link:hover,\n .hero.is-black .navbar-link.is-active {\n background-color: black;\n color: white; }\n .hero.is-black .tabs a {\n color: white;\n opacity: 0.9; }\n .hero.is-black .tabs a:hover {\n opacity: 1; }\n .hero.is-black .tabs li.is-active a {\n color: #0a0a0a !important;\n opacity: 1; }\n .hero.is-black .tabs.is-boxed a, .hero.is-black .tabs.is-toggle a {\n color: white; }\n .hero.is-black .tabs.is-boxed a:hover, .hero.is-black .tabs.is-toggle a:hover {\n background-color: rgba(10, 10, 10, 0.1); }\n .hero.is-black .tabs.is-boxed li.is-active a, .hero.is-black .tabs.is-boxed li.is-active a:hover, .hero.is-black .tabs.is-toggle li.is-active a, .hero.is-black .tabs.is-toggle li.is-active a:hover {\n background-color: white;\n border-color: white;\n color: #0a0a0a; }\n .hero.is-black.is-bold {\n background-image: linear-gradient(141deg, black 0%, #0a0a0a 71%, #181616 100%); }\n @media screen and (max-width: 768px) {\n .hero.is-black.is-bold .navbar-menu {\n background-image: linear-gradient(141deg, black 0%, #0a0a0a 71%, #181616 100%); } }\n .hero.is-light {\n background-color: whitesmoke;\n color: rgba(0, 0, 0, 0.7); }\n .hero.is-light a:not(.button):not(.dropdown-item):not(.tag):not(.pagination-link.is-current),\n .hero.is-light strong {\n color: inherit; }\n .hero.is-light .title {\n color: rgba(0, 0, 0, 0.7); }\n .hero.is-light .subtitle {\n color: rgba(0, 0, 0, 0.9); }\n .hero.is-light .subtitle a:not(.button),\n .hero.is-light .subtitle strong {\n color: rgba(0, 0, 0, 0.7); }\n @media screen and (max-width: 1023px) {\n .hero.is-light .navbar-menu {\n background-color: whitesmoke; } }\n .hero.is-light .navbar-item,\n .hero.is-light .navbar-link {\n color: rgba(0, 0, 0, 0.7); }\n .hero.is-light a.navbar-item:hover, .hero.is-light a.navbar-item.is-active,\n .hero.is-light .navbar-link:hover,\n .hero.is-light .navbar-link.is-active {\n background-color: #e8e8e8;\n color: rgba(0, 0, 0, 0.7); }\n .hero.is-light .tabs a {\n color: rgba(0, 0, 0, 0.7);\n opacity: 0.9; }\n .hero.is-light .tabs a:hover {\n opacity: 1; }\n .hero.is-light .tabs li.is-active a {\n color: whitesmoke !important;\n opacity: 1; }\n .hero.is-light .tabs.is-boxed a, .hero.is-light .tabs.is-toggle a {\n color: rgba(0, 0, 0, 0.7); }\n .hero.is-light .tabs.is-boxed a:hover, .hero.is-light .tabs.is-toggle a:hover {\n background-color: rgba(10, 10, 10, 0.1); }\n .hero.is-light .tabs.is-boxed li.is-active a, .hero.is-light .tabs.is-boxed li.is-active a:hover, .hero.is-light .tabs.is-toggle li.is-active a, .hero.is-light .tabs.is-toggle li.is-active a:hover {\n background-color: rgba(0, 0, 0, 0.7);\n border-color: rgba(0, 0, 0, 0.7);\n color: whitesmoke; }\n .hero.is-light.is-bold {\n background-image: linear-gradient(141deg, #dfd8d9 0%, whitesmoke 71%, white 100%); }\n @media screen and (max-width: 768px) {\n .hero.is-light.is-bold .navbar-menu {\n background-image: linear-gradient(141deg, #dfd8d9 0%, whitesmoke 71%, white 100%); } }\n .hero.is-dark {\n background-color: #363636;\n color: #fff; }\n .hero.is-dark a:not(.button):not(.dropdown-item):not(.tag):not(.pagination-link.is-current),\n .hero.is-dark strong {\n color: inherit; }\n .hero.is-dark .title {\n color: #fff; }\n .hero.is-dark .subtitle {\n color: rgba(255, 255, 255, 0.9); }\n .hero.is-dark .subtitle a:not(.button),\n .hero.is-dark .subtitle strong {\n color: #fff; }\n @media screen and (max-width: 1023px) {\n .hero.is-dark .navbar-menu {\n background-color: #363636; } }\n .hero.is-dark .navbar-item,\n .hero.is-dark .navbar-link {\n color: rgba(255, 255, 255, 0.7); }\n .hero.is-dark a.navbar-item:hover, .hero.is-dark a.navbar-item.is-active,\n .hero.is-dark .navbar-link:hover,\n .hero.is-dark .navbar-link.is-active {\n background-color: #292929;\n color: #fff; }\n .hero.is-dark .tabs a {\n color: #fff;\n opacity: 0.9; }\n .hero.is-dark .tabs a:hover {\n opacity: 1; }\n .hero.is-dark .tabs li.is-active a {\n color: #363636 !important;\n opacity: 1; }\n .hero.is-dark .tabs.is-boxed a, .hero.is-dark .tabs.is-toggle a {\n color: #fff; }\n .hero.is-dark .tabs.is-boxed a:hover, .hero.is-dark .tabs.is-toggle a:hover {\n background-color: rgba(10, 10, 10, 0.1); }\n .hero.is-dark .tabs.is-boxed li.is-active a, .hero.is-dark .tabs.is-boxed li.is-active a:hover, .hero.is-dark .tabs.is-toggle li.is-active a, .hero.is-dark .tabs.is-toggle li.is-active a:hover {\n background-color: #fff;\n border-color: #fff;\n color: #363636; }\n .hero.is-dark.is-bold {\n background-image: linear-gradient(141deg, #1f191a 0%, #363636 71%, #46403f 100%); }\n @media screen and (max-width: 768px) {\n .hero.is-dark.is-bold .navbar-menu {\n background-image: linear-gradient(141deg, #1f191a 0%, #363636 71%, #46403f 100%); } }\n .hero.is-primary {\n background-color: #ff0d68;\n color: #fff; }\n .hero.is-primary a:not(.button):not(.dropdown-item):not(.tag):not(.pagination-link.is-current),\n .hero.is-primary strong {\n color: inherit; }\n .hero.is-primary .title {\n color: #fff; }\n .hero.is-primary .subtitle {\n color: rgba(255, 255, 255, 0.9); }\n .hero.is-primary .subtitle a:not(.button),\n .hero.is-primary .subtitle strong {\n color: #fff; }\n @media screen and (max-width: 1023px) {\n .hero.is-primary .navbar-menu {\n background-color: #ff0d68; } }\n .hero.is-primary .navbar-item,\n .hero.is-primary .navbar-link {\n color: rgba(255, 255, 255, 0.7); }\n .hero.is-primary a.navbar-item:hover, .hero.is-primary a.navbar-item.is-active,\n .hero.is-primary .navbar-link:hover,\n .hero.is-primary .navbar-link.is-active {\n background-color: #f3005b;\n color: #fff; }\n .hero.is-primary .tabs a {\n color: #fff;\n opacity: 0.9; }\n .hero.is-primary .tabs a:hover {\n opacity: 1; }\n .hero.is-primary .tabs li.is-active a {\n color: #ff0d68 !important;\n opacity: 1; }\n .hero.is-primary .tabs.is-boxed a, .hero.is-primary .tabs.is-toggle a {\n color: #fff; }\n .hero.is-primary .tabs.is-boxed a:hover, .hero.is-primary .tabs.is-toggle a:hover {\n background-color: rgba(10, 10, 10, 0.1); }\n .hero.is-primary .tabs.is-boxed li.is-active a, .hero.is-primary .tabs.is-boxed li.is-active a:hover, .hero.is-primary .tabs.is-toggle li.is-active a, .hero.is-primary .tabs.is-toggle li.is-active a:hover {\n background-color: #fff;\n border-color: #fff;\n color: #ff0d68; }\n .hero.is-primary.is-bold {\n background-image: linear-gradient(141deg, #d90076 0%, #ff0d68 71%, #ff2754 100%); }\n @media screen and (max-width: 768px) {\n .hero.is-primary.is-bold .navbar-menu {\n background-image: linear-gradient(141deg, #d90076 0%, #ff0d68 71%, #ff2754 100%); } }\n .hero.is-link {\n background-color: #ff0d68;\n color: #fff; }\n .hero.is-link a:not(.button):not(.dropdown-item):not(.tag):not(.pagination-link.is-current),\n .hero.is-link strong {\n color: inherit; }\n .hero.is-link .title {\n color: #fff; }\n .hero.is-link .subtitle {\n color: rgba(255, 255, 255, 0.9); }\n .hero.is-link .subtitle a:not(.button),\n .hero.is-link .subtitle strong {\n color: #fff; }\n @media screen and (max-width: 1023px) {\n .hero.is-link .navbar-menu {\n background-color: #ff0d68; } }\n .hero.is-link .navbar-item,\n .hero.is-link .navbar-link {\n color: rgba(255, 255, 255, 0.7); }\n .hero.is-link a.navbar-item:hover, .hero.is-link a.navbar-item.is-active,\n .hero.is-link .navbar-link:hover,\n .hero.is-link .navbar-link.is-active {\n background-color: #f3005b;\n color: #fff; }\n .hero.is-link .tabs a {\n color: #fff;\n opacity: 0.9; }\n .hero.is-link .tabs a:hover {\n opacity: 1; }\n .hero.is-link .tabs li.is-active a {\n color: #ff0d68 !important;\n opacity: 1; }\n .hero.is-link .tabs.is-boxed a, .hero.is-link .tabs.is-toggle a {\n color: #fff; }\n .hero.is-link .tabs.is-boxed a:hover, .hero.is-link .tabs.is-toggle a:hover {\n background-color: rgba(10, 10, 10, 0.1); }\n .hero.is-link .tabs.is-boxed li.is-active a, .hero.is-link .tabs.is-boxed li.is-active a:hover, .hero.is-link .tabs.is-toggle li.is-active a, .hero.is-link .tabs.is-toggle li.is-active a:hover {\n background-color: #fff;\n border-color: #fff;\n color: #ff0d68; }\n .hero.is-link.is-bold {\n background-image: linear-gradient(141deg, #d90076 0%, #ff0d68 71%, #ff2754 100%); }\n @media screen and (max-width: 768px) {\n .hero.is-link.is-bold .navbar-menu {\n background-image: linear-gradient(141deg, #d90076 0%, #ff0d68 71%, #ff2754 100%); } }\n .hero.is-info {\n background-color: #0092FF;\n color: #fff; }\n .hero.is-info a:not(.button):not(.dropdown-item):not(.tag):not(.pagination-link.is-current),\n .hero.is-info strong {\n color: inherit; }\n .hero.is-info .title {\n color: #fff; }\n .hero.is-info .subtitle {\n color: rgba(255, 255, 255, 0.9); }\n .hero.is-info .subtitle a:not(.button),\n .hero.is-info .subtitle strong {\n color: #fff; }\n @media screen and (max-width: 1023px) {\n .hero.is-info .navbar-menu {\n background-color: #0092FF; } }\n .hero.is-info .navbar-item,\n .hero.is-info .navbar-link {\n color: rgba(255, 255, 255, 0.7); }\n .hero.is-info a.navbar-item:hover, .hero.is-info a.navbar-item.is-active,\n .hero.is-info .navbar-link:hover,\n .hero.is-info .navbar-link.is-active {\n background-color: #0083e6;\n color: #fff; }\n .hero.is-info .tabs a {\n color: #fff;\n opacity: 0.9; }\n .hero.is-info .tabs a:hover {\n opacity: 1; }\n .hero.is-info .tabs li.is-active a {\n color: #0092FF !important;\n opacity: 1; }\n .hero.is-info .tabs.is-boxed a, .hero.is-info .tabs.is-toggle a {\n color: #fff; }\n .hero.is-info .tabs.is-boxed a:hover, .hero.is-info .tabs.is-toggle a:hover {\n background-color: rgba(10, 10, 10, 0.1); }\n .hero.is-info .tabs.is-boxed li.is-active a, .hero.is-info .tabs.is-boxed li.is-active a:hover, .hero.is-info .tabs.is-toggle li.is-active a, .hero.is-info .tabs.is-toggle li.is-active a:hover {\n background-color: #fff;\n border-color: #fff;\n color: #0092FF; }\n .hero.is-info.is-bold {\n background-image: linear-gradient(141deg, #0097cc 0%, #0092FF 71%, #1a77ff 100%); }\n @media screen and (max-width: 768px) {\n .hero.is-info.is-bold .navbar-menu {\n background-image: linear-gradient(141deg, #0097cc 0%, #0092FF 71%, #1a77ff 100%); } }\n .hero.is-success {\n background-color: #16DB93;\n color: rgba(0, 0, 0, 0.7); }\n .hero.is-success a:not(.button):not(.dropdown-item):not(.tag):not(.pagination-link.is-current),\n .hero.is-success strong {\n color: inherit; }\n .hero.is-success .title {\n color: rgba(0, 0, 0, 0.7); }\n .hero.is-success .subtitle {\n color: rgba(0, 0, 0, 0.9); }\n .hero.is-success .subtitle a:not(.button),\n .hero.is-success .subtitle strong {\n color: rgba(0, 0, 0, 0.7); }\n @media screen and (max-width: 1023px) {\n .hero.is-success .navbar-menu {\n background-color: #16DB93; } }\n .hero.is-success .navbar-item,\n .hero.is-success .navbar-link {\n color: rgba(0, 0, 0, 0.7); }\n .hero.is-success a.navbar-item:hover, .hero.is-success a.navbar-item.is-active,\n .hero.is-success .navbar-link:hover,\n .hero.is-success .navbar-link.is-active {\n background-color: #14c483;\n color: rgba(0, 0, 0, 0.7); }\n .hero.is-success .tabs a {\n color: rgba(0, 0, 0, 0.7);\n opacity: 0.9; }\n .hero.is-success .tabs a:hover {\n opacity: 1; }\n .hero.is-success .tabs li.is-active a {\n color: #16DB93 !important;\n opacity: 1; }\n .hero.is-success .tabs.is-boxed a, .hero.is-success .tabs.is-toggle a {\n color: rgba(0, 0, 0, 0.7); }\n .hero.is-success .tabs.is-boxed a:hover, .hero.is-success .tabs.is-toggle a:hover {\n background-color: rgba(10, 10, 10, 0.1); }\n .hero.is-success .tabs.is-boxed li.is-active a, .hero.is-success .tabs.is-boxed li.is-active a:hover, .hero.is-success .tabs.is-toggle li.is-active a, .hero.is-success .tabs.is-toggle li.is-active a:hover {\n background-color: rgba(0, 0, 0, 0.7);\n border-color: rgba(0, 0, 0, 0.7);\n color: #16DB93; }\n .hero.is-success.is-bold {\n background-image: linear-gradient(141deg, #08b659 0%, #16DB93 71%, #1cefc5 100%); }\n @media screen and (max-width: 768px) {\n .hero.is-success.is-bold .navbar-menu {\n background-image: linear-gradient(141deg, #08b659 0%, #16DB93 71%, #1cefc5 100%); } }\n .hero.is-warning {\n background-color: #FFE900;\n color: rgba(0, 0, 0, 0.7); }\n .hero.is-warning a:not(.button):not(.dropdown-item):not(.tag):not(.pagination-link.is-current),\n .hero.is-warning strong {\n color: inherit; }\n .hero.is-warning .title {\n color: rgba(0, 0, 0, 0.7); }\n .hero.is-warning .subtitle {\n color: rgba(0, 0, 0, 0.9); }\n .hero.is-warning .subtitle a:not(.button),\n .hero.is-warning .subtitle strong {\n color: rgba(0, 0, 0, 0.7); }\n @media screen and (max-width: 1023px) {\n .hero.is-warning .navbar-menu {\n background-color: #FFE900; } }\n .hero.is-warning .navbar-item,\n .hero.is-warning .navbar-link {\n color: rgba(0, 0, 0, 0.7); }\n .hero.is-warning a.navbar-item:hover, .hero.is-warning a.navbar-item.is-active,\n .hero.is-warning .navbar-link:hover,\n .hero.is-warning .navbar-link.is-active {\n background-color: #e6d200;\n color: rgba(0, 0, 0, 0.7); }\n .hero.is-warning .tabs a {\n color: rgba(0, 0, 0, 0.7);\n opacity: 0.9; }\n .hero.is-warning .tabs a:hover {\n opacity: 1; }\n .hero.is-warning .tabs li.is-active a {\n color: #FFE900 !important;\n opacity: 1; }\n .hero.is-warning .tabs.is-boxed a, .hero.is-warning .tabs.is-toggle a {\n color: rgba(0, 0, 0, 0.7); }\n .hero.is-warning .tabs.is-boxed a:hover, .hero.is-warning .tabs.is-toggle a:hover {\n background-color: rgba(10, 10, 10, 0.1); }\n .hero.is-warning .tabs.is-boxed li.is-active a, .hero.is-warning .tabs.is-boxed li.is-active a:hover, .hero.is-warning .tabs.is-toggle li.is-active a, .hero.is-warning .tabs.is-toggle li.is-active a:hover {\n background-color: rgba(0, 0, 0, 0.7);\n border-color: rgba(0, 0, 0, 0.7);\n color: #FFE900; }\n .hero.is-warning.is-bold {\n background-image: linear-gradient(141deg, #cc9800 0%, #FFE900 71%, #edff1a 100%); }\n @media screen and (max-width: 768px) {\n .hero.is-warning.is-bold .navbar-menu {\n background-image: linear-gradient(141deg, #cc9800 0%, #FFE900 71%, #edff1a 100%); } }\n .hero.is-danger {\n background-color: #f14668;\n color: #fff; }\n .hero.is-danger a:not(.button):not(.dropdown-item):not(.tag):not(.pagination-link.is-current),\n .hero.is-danger strong {\n color: inherit; }\n .hero.is-danger .title {\n color: #fff; }\n .hero.is-danger .subtitle {\n color: rgba(255, 255, 255, 0.9); }\n .hero.is-danger .subtitle a:not(.button),\n .hero.is-danger .subtitle strong {\n color: #fff; }\n @media screen and (max-width: 1023px) {\n .hero.is-danger .navbar-menu {\n background-color: #f14668; } }\n .hero.is-danger .navbar-item,\n .hero.is-danger .navbar-link {\n color: rgba(255, 255, 255, 0.7); }\n .hero.is-danger a.navbar-item:hover, .hero.is-danger a.navbar-item.is-active,\n .hero.is-danger .navbar-link:hover,\n .hero.is-danger .navbar-link.is-active {\n background-color: #ef2e55;\n color: #fff; }\n .hero.is-danger .tabs a {\n color: #fff;\n opacity: 0.9; }\n .hero.is-danger .tabs a:hover {\n opacity: 1; }\n .hero.is-danger .tabs li.is-active a {\n color: #f14668 !important;\n opacity: 1; }\n .hero.is-danger .tabs.is-boxed a, .hero.is-danger .tabs.is-toggle a {\n color: #fff; }\n .hero.is-danger .tabs.is-boxed a:hover, .hero.is-danger .tabs.is-toggle a:hover {\n background-color: rgba(10, 10, 10, 0.1); }\n .hero.is-danger .tabs.is-boxed li.is-active a, .hero.is-danger .tabs.is-boxed li.is-active a:hover, .hero.is-danger .tabs.is-toggle li.is-active a, .hero.is-danger .tabs.is-toggle li.is-active a:hover {\n background-color: #fff;\n border-color: #fff;\n color: #f14668; }\n .hero.is-danger.is-bold {\n background-image: linear-gradient(141deg, #fa0a62 0%, #f14668 71%, #f7595f 100%); }\n @media screen and (max-width: 768px) {\n .hero.is-danger.is-bold .navbar-menu {\n background-image: linear-gradient(141deg, #fa0a62 0%, #f14668 71%, #f7595f 100%); } }\n .hero.is-small .hero-body {\n padding: 1.5rem; }\n @media screen and (min-width: 769px), print {\n .hero.is-medium .hero-body {\n padding: 9rem 4.5rem; } }\n @media screen and (min-width: 769px), print {\n .hero.is-large .hero-body {\n padding: 18rem 6rem; } }\n .hero.is-halfheight .hero-body, .hero.is-fullheight .hero-body, .hero.is-fullheight-with-navbar .hero-body {\n align-items: center;\n display: flex; }\n .hero.is-halfheight .hero-body > .container, .hero.is-fullheight .hero-body > .container, .hero.is-fullheight-with-navbar .hero-body > .container {\n flex-grow: 1;\n flex-shrink: 1; }\n .hero.is-halfheight {\n min-height: 50vh; }\n .hero.is-fullheight {\n min-height: 100vh; }\n\n.hero-video {\n overflow: hidden; }\n .hero-video video {\n left: 50%;\n min-height: 100%;\n min-width: 100%;\n position: absolute;\n top: 50%;\n transform: translate3d(-50%, -50%, 0); }\n .hero-video.is-transparent {\n opacity: 0.3; }\n @media screen and (max-width: 768px) {\n .hero-video {\n display: none; } }\n.hero-buttons {\n margin-top: 1.5rem; }\n @media screen and (max-width: 768px) {\n .hero-buttons .button {\n display: flex; }\n .hero-buttons .button:not(:last-child) {\n margin-bottom: 0.75rem; } }\n @media screen and (min-width: 769px), print {\n .hero-buttons {\n display: flex;\n justify-content: center; }\n .hero-buttons .button:not(:last-child) {\n margin-right: 1.5rem; } }\n.hero-head,\n.hero-foot {\n flex-grow: 0;\n flex-shrink: 0; }\n\n.hero-body {\n flex-grow: 1;\n flex-shrink: 0;\n padding: 3rem 1.5rem; }\n @media screen and (min-width: 769px), print {\n .hero-body {\n padding: 3rem 3rem; } }\n.section {\n padding: 3rem 1.5rem; }\n @media screen and (min-width: 1024px) {\n .section {\n padding: 3rem 3rem; }\n .section.is-medium {\n padding: 9rem 4.5rem; }\n .section.is-large {\n padding: 18rem 6rem; } }\n.footer {\n background-color: #fafafa;\n padding: 3rem 1.5rem 6rem; }\n\n/*! Bulma Prefers Dark | MIT License | github.com/jloh/bulma-prefers-dark */\n@media (prefers-color-scheme: dark) {\n html {\n background-color: #17181c; }\n body {\n color: #b5b5b5; }\n a {\n color: #e60056; }\n a:hover {\n color: #dbdbdb; }\n code {\n background-color: #242424;\n color: #da1039; }\n hr {\n background-color: #242424; }\n strong {\n color: #dbdbdb; }\n pre {\n background-color: #242424;\n color: #b5b5b5; }\n table th {\n color: #dbdbdb; }\n .has-text-white-dark {\n color: white !important; }\n a.has-text-white-dark:hover, a.has-text-white-dark:focus {\n color: white !important; }\n .has-background-white-dark {\n background-color: white !important; }\n .has-text-black-dark {\n color: #0a0a0a !important; }\n a.has-text-black-dark:hover, a.has-text-black-dark:focus {\n color: #242424 !important; }\n .has-background-black-dark {\n background-color: #0a0a0a !important; }\n .has-text-light-dark {\n color: whitesmoke !important; }\n a.has-text-light-dark:hover, a.has-text-light-dark:focus {\n color: white !important; }\n .has-background-light-dark {\n background-color: whitesmoke !important; }\n .has-text-dark-dark {\n color: #363636 !important; }\n a.has-text-dark-dark:hover, a.has-text-dark-dark:focus {\n color: #4f4f4f !important; }\n .has-background-dark-dark {\n background-color: #363636 !important; }\n .has-text-primary-dark {\n color: #ff0d68 !important; }\n a.has-text-primary-dark:hover, a.has-text-primary-dark:focus {\n color: #ff4088 !important; }\n .has-background-primary-dark {\n background-color: #ff0d68 !important; }\n .has-text-link-dark {\n color: #ff0d68 !important; }\n a.has-text-link-dark:hover, a.has-text-link-dark:focus {\n color: #ff4088 !important; }\n .has-background-link-dark {\n background-color: #ff0d68 !important; }\n .has-text-info-dark {\n color: #0092FF !important; }\n a.has-text-info-dark:hover, a.has-text-info-dark:focus {\n color: #33a8ff !important; }\n .has-background-info-dark {\n background-color: #0092FF !important; }\n .has-text-success-dark {\n color: #16DB93 !important; }\n a.has-text-success-dark:hover, a.has-text-success-dark:focus {\n color: #39ebaa !important; }\n .has-background-success-dark {\n background-color: #16DB93 !important; }\n .has-text-warning-dark {\n color: #FFE900 !important; }\n a.has-text-warning-dark:hover, a.has-text-warning-dark:focus {\n color: #ffed33 !important; }\n .has-background-warning-dark {\n background-color: #FFE900 !important; }\n .has-text-danger-dark {\n color: #f14668 !important; }\n a.has-text-danger-dark:hover, a.has-text-danger-dark:focus {\n color: #f5758f !important; }\n .has-background-danger-dark {\n background-color: #f14668 !important; }\n .has-text-black-bis-dark {\n color: #121212 !important; }\n .has-background-black-bis-dark {\n background-color: #121212 !important; }\n .has-text-black-ter-dark {\n color: #242424 !important; }\n .has-background-black-ter-dark {\n background-color: #242424 !important; }\n .has-text-grey-darker-dark {\n color: #363636 !important; }\n .has-background-grey-darker-dark {\n background-color: #363636 !important; }\n .has-text-grey-dark-dark {\n color: #4a4a4a !important; }\n .has-background-grey-dark-dark {\n background-color: #4a4a4a !important; }\n .has-text-grey-dark {\n color: #7a7a7a !important; }\n .has-background-grey-dark {\n background-color: #7a7a7a !important; }\n .has-text-grey-light-dark {\n color: #b5b5b5 !important; }\n .has-background-grey-light-dark {\n background-color: #b5b5b5 !important; }\n .has-text-grey-lighter-dark {\n color: #dbdbdb !important; }\n .has-background-grey-lighter-dark {\n background-color: #dbdbdb !important; }\n .has-text-white-ter-dark {\n color: whitesmoke !important; }\n .has-background-white-ter-dark {\n background-color: whitesmoke !important; }\n .has-text-white-bis-dark {\n color: #fafafa !important; }\n .has-background-white-bis-dark {\n background-color: #fafafa !important; }\n .box {\n background-color: #0a0a0a;\n box-shadow: 0 2px 3px rgba(255, 255, 255, 0.1), 0 0 0 1px rgba(255, 255, 255, 0.1);\n color: #b5b5b5; }\n a.box:hover, a.box:focus {\n box-shadow: 0 2px 3px rgba(255, 255, 255, 0.1), 0 0 0 1px #e60056; }\n a.box:active {\n box-shadow: inset 0 1px 2px rgba(255, 255, 255, 0.2), 0 0 0 1px #e60056; }\n .button {\n background-color: #0a0a0a;\n border-color: #363636;\n color: #dbdbdb; }\n .button:hover, .button.is-hovered {\n border-color: #4a4a4a;\n color: #dbdbdb; }\n .button:focus, .button.is-focused {\n border-color: #5ea3e4;\n color: #dbdbdb; }\n .button:focus:not(:active), .button.is-focused:not(:active) {\n box-shadow: 0 0 0 0.125em rgba(230, 0, 86, 0.25); }\n .button:active, .button.is-active {\n border-color: #b5b5b5;\n color: #dbdbdb; }\n .button.is-text {\n color: #b5b5b5; }\n .button.is-text:hover, .button.is-text.is-hovered, .button.is-text:focus, .button.is-text.is-focused {\n background-color: #242424;\n color: #dbdbdb; }\n .button.is-text:active, .button.is-text.is-active {\n background-color: #171717;\n color: #dbdbdb; }\n .button.is-white {\n background-color: #e6e6e6;\n border-color: transparent;\n color: #0a0a0a; }\n .button.is-white:hover, .button.is-white.is-hovered {\n background-color: #dfdfdf;\n border-color: transparent;\n color: #0a0a0a; }\n .button.is-white:focus, .button.is-white.is-focused {\n border-color: transparent;\n color: #0a0a0a; }\n .button.is-white:focus:not(:active), .button.is-white.is-focused:not(:active) {\n box-shadow: 0 0 0 0.125em rgba(230, 230, 230, 0.25); }\n .button.is-white:active, .button.is-white.is-active {\n background-color: #d9d9d9;\n border-color: transparent;\n color: #0a0a0a; }\n .button.is-white[disabled], fieldset[disabled] .button.is-white {\n background-color: #e6e6e6;\n border-color: transparent;\n box-shadow: none; }\n .button.is-white.is-inverted {\n background-color: #0a0a0a;\n color: #e6e6e6; }\n .button.is-white.is-inverted:hover {\n background-color: black; }\n .button.is-white.is-inverted[disabled], fieldset[disabled] .button.is-white.is-inverted {\n background-color: #0a0a0a;\n border-color: transparent;\n box-shadow: none;\n color: #e6e6e6; }\n .button.is-white.is-loading::after {\n border-color: transparent transparent #0a0a0a #0a0a0a !important; }\n .button.is-white.is-outlined {\n background-color: transparent;\n border-color: #e6e6e6;\n color: #e6e6e6; }\n .button.is-white.is-outlined:hover, .button.is-white.is-outlined:focus {\n background-color: #e6e6e6;\n border-color: #e6e6e6;\n color: #0a0a0a; }\n .button.is-white.is-outlined.is-loading::after {\n border-color: transparent transparent #e6e6e6 #e6e6e6 !important; }\n .button.is-white.is-outlined[disabled], fieldset[disabled] .button.is-white.is-outlined {\n background-color: transparent;\n border-color: #e6e6e6;\n box-shadow: none;\n color: #e6e6e6; }\n .button.is-white.is-inverted.is-outlined {\n background-color: transparent;\n border-color: #0a0a0a;\n color: #0a0a0a; }\n .button.is-white.is-inverted.is-outlined:hover, .button.is-white.is-inverted.is-outlined:focus {\n background-color: #0a0a0a;\n color: #e6e6e6; }\n .button.is-white.is-inverted.is-outlined[disabled], fieldset[disabled] .button.is-white.is-inverted.is-outlined {\n background-color: transparent;\n border-color: #0a0a0a;\n box-shadow: none;\n color: #0a0a0a; }\n .button.is-black {\n background-color: black;\n border-color: transparent;\n color: white; }\n .button.is-black:hover, .button.is-black.is-hovered {\n background-color: black;\n border-color: transparent;\n color: white; }\n .button.is-black:focus, .button.is-black.is-focused {\n border-color: transparent;\n color: white; }\n .button.is-black:focus:not(:active), .button.is-black.is-focused:not(:active) {\n box-shadow: 0 0 0 0.125em rgba(0, 0, 0, 0.25); }\n .button.is-black:active, .button.is-black.is-active {\n background-color: black;\n border-color: transparent;\n color: white; }\n .button.is-black[disabled], fieldset[disabled] .button.is-black {\n background-color: black;\n border-color: transparent;\n box-shadow: none; }\n .button.is-black.is-inverted {\n background-color: white;\n color: black; }\n .button.is-black.is-inverted:hover {\n background-color: #f2f2f2; }\n .button.is-black.is-inverted[disabled], fieldset[disabled] .button.is-black.is-inverted {\n background-color: white;\n border-color: transparent;\n box-shadow: none;\n color: black; }\n .button.is-black.is-loading::after {\n border-color: transparent transparent white white !important; }\n .button.is-black.is-outlined {\n background-color: transparent;\n border-color: black;\n color: black; }\n .button.is-black.is-outlined:hover, .button.is-black.is-outlined:focus {\n background-color: black;\n border-color: black;\n color: white; }\n .button.is-black.is-outlined.is-loading::after {\n border-color: transparent transparent black black !important; }\n .button.is-black.is-outlined[disabled], fieldset[disabled] .button.is-black.is-outlined {\n background-color: transparent;\n border-color: black;\n box-shadow: none;\n color: black; }\n .button.is-black.is-inverted.is-outlined {\n background-color: transparent;\n border-color: white;\n color: white; }\n .button.is-black.is-inverted.is-outlined:hover, .button.is-black.is-inverted.is-outlined:focus {\n background-color: white;\n color: black; }\n .button.is-black.is-inverted.is-outlined[disabled], fieldset[disabled] .button.is-black.is-inverted.is-outlined {\n background-color: transparent;\n border-color: white;\n box-shadow: none;\n color: white; }\n .button.is-light {\n background-color: #dbdbdb;\n border-color: transparent;\n color: rgba(0, 0, 0, 0.7); }\n .button.is-light:hover, .button.is-light.is-hovered {\n background-color: #d5d5d5;\n border-color: transparent;\n color: rgba(0, 0, 0, 0.7); }\n .button.is-light:focus, .button.is-light.is-focused {\n border-color: transparent;\n color: rgba(0, 0, 0, 0.7); }\n .button.is-light:focus:not(:active), .button.is-light.is-focused:not(:active) {\n box-shadow: 0 0 0 0.125em rgba(219, 219, 219, 0.25); }\n .button.is-light:active, .button.is-light.is-active {\n background-color: #cfcfcf;\n border-color: transparent;\n color: rgba(0, 0, 0, 0.7); }\n .button.is-light[disabled], fieldset[disabled] .button.is-light {\n background-color: #dbdbdb;\n border-color: transparent;\n box-shadow: none; }\n .button.is-light.is-inverted {\n background-color: rgba(0, 0, 0, 0.7);\n color: #dbdbdb; }\n .button.is-light.is-inverted:hover {\n background-color: rgba(0, 0, 0, 0.7); }\n .button.is-light.is-inverted[disabled], fieldset[disabled] .button.is-light.is-inverted {\n background-color: rgba(0, 0, 0, 0.7);\n border-color: transparent;\n box-shadow: none;\n color: #dbdbdb; }\n .button.is-light.is-loading::after {\n border-color: transparent transparent rgba(0, 0, 0, 0.7) rgba(0, 0, 0, 0.7) !important; }\n .button.is-light.is-outlined {\n background-color: transparent;\n border-color: #dbdbdb;\n color: #dbdbdb; }\n .button.is-light.is-outlined:hover, .button.is-light.is-outlined:focus {\n background-color: #dbdbdb;\n border-color: #dbdbdb;\n color: rgba(0, 0, 0, 0.7); }\n .button.is-light.is-outlined.is-loading::after {\n border-color: transparent transparent #dbdbdb #dbdbdb !important; }\n .button.is-light.is-outlined[disabled], fieldset[disabled] .button.is-light.is-outlined {\n background-color: transparent;\n border-color: #dbdbdb;\n box-shadow: none;\n color: #dbdbdb; }\n .button.is-light.is-inverted.is-outlined {\n background-color: transparent;\n border-color: rgba(0, 0, 0, 0.7);\n color: rgba(0, 0, 0, 0.7); }\n .button.is-light.is-inverted.is-outlined:hover, .button.is-light.is-inverted.is-outlined:focus {\n background-color: rgba(0, 0, 0, 0.7);\n color: #dbdbdb; }\n .button.is-light.is-inverted.is-outlined[disabled], fieldset[disabled] .button.is-light.is-inverted.is-outlined {\n background-color: transparent;\n border-color: rgba(0, 0, 0, 0.7);\n box-shadow: none;\n color: rgba(0, 0, 0, 0.7); }\n .button.is-dark {\n background-color: #1c1c1c;\n border-color: transparent;\n color: #fff; }\n .button.is-dark:hover, .button.is-dark.is-hovered {\n background-color: #161616;\n border-color: transparent;\n color: #fff; }\n .button.is-dark:focus, .button.is-dark.is-focused {\n border-color: transparent;\n color: #fff; }\n .button.is-dark:focus:not(:active), .button.is-dark.is-focused:not(:active) {\n box-shadow: 0 0 0 0.125em rgba(28, 28, 28, 0.25); }\n .button.is-dark:active, .button.is-dark.is-active {\n background-color: #0f0f0f;\n border-color: transparent;\n color: #fff; }\n .button.is-dark[disabled], fieldset[disabled] .button.is-dark {\n background-color: #1c1c1c;\n border-color: transparent;\n box-shadow: none; }\n .button.is-dark.is-inverted {\n background-color: #fff;\n color: #1c1c1c; }\n .button.is-dark.is-inverted:hover {\n background-color: #f2f2f2; }\n .button.is-dark.is-inverted[disabled], fieldset[disabled] .button.is-dark.is-inverted {\n background-color: #fff;\n border-color: transparent;\n box-shadow: none;\n color: #1c1c1c; }\n .button.is-dark.is-loading::after {\n border-color: transparent transparent #fff #fff !important; }\n .button.is-dark.is-outlined {\n background-color: transparent;\n border-color: #1c1c1c;\n color: #1c1c1c; }\n .button.is-dark.is-outlined:hover, .button.is-dark.is-outlined:focus {\n background-color: #1c1c1c;\n border-color: #1c1c1c;\n color: #fff; }\n .button.is-dark.is-outlined.is-loading::after {\n border-color: transparent transparent #1c1c1c #1c1c1c !important; }\n .button.is-dark.is-outlined[disabled], fieldset[disabled] .button.is-dark.is-outlined {\n background-color: transparent;\n border-color: #1c1c1c;\n box-shadow: none;\n color: #1c1c1c; }\n .button.is-dark.is-inverted.is-outlined {\n background-color: transparent;\n border-color: #fff;\n color: #fff; }\n .button.is-dark.is-inverted.is-outlined:hover, .button.is-dark.is-inverted.is-outlined:focus {\n background-color: #fff;\n color: #1c1c1c; }\n .button.is-dark.is-inverted.is-outlined[disabled], fieldset[disabled] .button.is-dark.is-inverted.is-outlined {\n background-color: transparent;\n border-color: #fff;\n box-shadow: none;\n color: #fff; }\n .button.is-primary {\n background-color: #d90052;\n border-color: transparent;\n color: #fff; }\n .button.is-primary:hover, .button.is-primary.is-hovered {\n background-color: #cc004d;\n border-color: transparent;\n color: #fff; }\n .button.is-primary:focus, .button.is-primary.is-focused {\n border-color: transparent;\n color: #fff; }\n .button.is-primary:focus:not(:active), .button.is-primary.is-focused:not(:active) {\n box-shadow: 0 0 0 0.125em rgba(217, 0, 82, 0.25); }\n .button.is-primary:active, .button.is-primary.is-active {\n background-color: #c00048;\n border-color: transparent;\n color: #fff; }\n .button.is-primary[disabled], fieldset[disabled] .button.is-primary {\n background-color: #d90052;\n border-color: transparent;\n box-shadow: none; }\n .button.is-primary.is-inverted {\n background-color: #fff;\n color: #d90052; }\n .button.is-primary.is-inverted:hover {\n background-color: #f2f2f2; }\n .button.is-primary.is-inverted[disabled], fieldset[disabled] .button.is-primary.is-inverted {\n background-color: #fff;\n border-color: transparent;\n box-shadow: none;\n color: #d90052; }\n .button.is-primary.is-loading::after {\n border-color: transparent transparent #fff #fff !important; }\n .button.is-primary.is-outlined {\n background-color: transparent;\n border-color: #d90052;\n color: #d90052; }\n .button.is-primary.is-outlined:hover, .button.is-primary.is-outlined:focus {\n background-color: #d90052;\n border-color: #d90052;\n color: #fff; }\n .button.is-primary.is-outlined.is-loading::after {\n border-color: transparent transparent #d90052 #d90052 !important; }\n .button.is-primary.is-outlined[disabled], fieldset[disabled] .button.is-primary.is-outlined {\n background-color: transparent;\n border-color: #d90052;\n box-shadow: none;\n color: #d90052; }\n .button.is-primary.is-inverted.is-outlined {\n background-color: transparent;\n border-color: #fff;\n color: #fff; }\n .button.is-primary.is-inverted.is-outlined:hover, .button.is-primary.is-inverted.is-outlined:focus {\n background-color: #fff;\n color: #d90052; }\n .button.is-primary.is-inverted.is-outlined[disabled], fieldset[disabled] .button.is-primary.is-inverted.is-outlined {\n background-color: transparent;\n border-color: #fff;\n box-shadow: none;\n color: #fff; }\n .button.is-link {\n background-color: #d90052;\n border-color: transparent;\n color: #fff; }\n .button.is-link:hover, .button.is-link.is-hovered {\n background-color: #cc004d;\n border-color: transparent;\n color: #fff; }\n .button.is-link:focus, .button.is-link.is-focused {\n border-color: transparent;\n color: #fff; }\n .button.is-link:focus:not(:active), .button.is-link.is-focused:not(:active) {\n box-shadow: 0 0 0 0.125em rgba(217, 0, 82, 0.25); }\n .button.is-link:active, .button.is-link.is-active {\n background-color: #c00048;\n border-color: transparent;\n color: #fff; }\n .button.is-link[disabled], fieldset[disabled] .button.is-link {\n background-color: #d90052;\n border-color: transparent;\n box-shadow: none; }\n .button.is-link.is-inverted {\n background-color: #fff;\n color: #d90052; }\n .button.is-link.is-inverted:hover {\n background-color: #f2f2f2; }\n .button.is-link.is-inverted[disabled], fieldset[disabled] .button.is-link.is-inverted {\n background-color: #fff;\n border-color: transparent;\n box-shadow: none;\n color: #d90052; }\n .button.is-link.is-loading::after {\n border-color: transparent transparent #fff #fff !important; }\n .button.is-link.is-outlined {\n background-color: transparent;\n border-color: #d90052;\n color: #d90052; }\n .button.is-link.is-outlined:hover, .button.is-link.is-outlined:focus {\n background-color: #d90052;\n border-color: #d90052;\n color: #fff; }\n .button.is-link.is-outlined.is-loading::after {\n border-color: transparent transparent #d90052 #d90052 !important; }\n .button.is-link.is-outlined[disabled], fieldset[disabled] .button.is-link.is-outlined {\n background-color: transparent;\n border-color: #d90052;\n box-shadow: none;\n color: #d90052; }\n .button.is-link.is-inverted.is-outlined {\n background-color: transparent;\n border-color: #fff;\n color: #fff; }\n .button.is-link.is-inverted.is-outlined:hover, .button.is-link.is-inverted.is-outlined:focus {\n background-color: #fff;\n color: #d90052; }\n .button.is-link.is-inverted.is-outlined[disabled], fieldset[disabled] .button.is-link.is-inverted.is-outlined {\n background-color: transparent;\n border-color: #fff;\n box-shadow: none;\n color: #fff; }\n .button.is-info {\n background-color: #0075cc;\n border-color: transparent;\n color: #fff; }\n .button.is-info:hover, .button.is-info.is-hovered {\n background-color: #006ebf;\n border-color: transparent;\n color: #fff; }\n .button.is-info:focus, .button.is-info.is-focused {\n border-color: transparent;\n color: #fff; }\n .button.is-info:focus:not(:active), .button.is-info.is-focused:not(:active) {\n box-shadow: 0 0 0 0.125em rgba(0, 117, 204, 0.25); }\n .button.is-info:active, .button.is-info.is-active {\n background-color: #0066b3;\n border-color: transparent;\n color: #fff; }\n .button.is-info[disabled], fieldset[disabled] .button.is-info {\n background-color: #0075cc;\n border-color: transparent;\n box-shadow: none; }\n .button.is-info.is-inverted {\n background-color: #fff;\n color: #0075cc; }\n .button.is-info.is-inverted:hover {\n background-color: #f2f2f2; }\n .button.is-info.is-inverted[disabled], fieldset[disabled] .button.is-info.is-inverted {\n background-color: #fff;\n border-color: transparent;\n box-shadow: none;\n color: #0075cc; }\n .button.is-info.is-loading::after {\n border-color: transparent transparent #fff #fff !important; }\n .button.is-info.is-outlined {\n background-color: transparent;\n border-color: #0075cc;\n color: #0075cc; }\n .button.is-info.is-outlined:hover, .button.is-info.is-outlined:focus {\n background-color: #0075cc;\n border-color: #0075cc;\n color: #fff; }\n .button.is-info.is-outlined.is-loading::after {\n border-color: transparent transparent #0075cc #0075cc !important; }\n .button.is-info.is-outlined[disabled], fieldset[disabled] .button.is-info.is-outlined {\n background-color: transparent;\n border-color: #0075cc;\n box-shadow: none;\n color: #0075cc; }\n .button.is-info.is-inverted.is-outlined {\n background-color: transparent;\n border-color: #fff;\n color: #fff; }\n .button.is-info.is-inverted.is-outlined:hover, .button.is-info.is-inverted.is-outlined:focus {\n background-color: #fff;\n color: #0075cc; }\n .button.is-info.is-inverted.is-outlined[disabled], fieldset[disabled] .button.is-info.is-inverted.is-outlined {\n background-color: transparent;\n border-color: #fff;\n box-shadow: none;\n color: #fff; }\n .button.is-success {\n background-color: #11ad74;\n border-color: transparent;\n color: rgba(0, 0, 0, 0.7); }\n .button.is-success:hover, .button.is-success.is-hovered {\n background-color: #10a16c;\n border-color: transparent;\n color: rgba(0, 0, 0, 0.7); }\n .button.is-success:focus, .button.is-success.is-focused {\n border-color: transparent;\n color: rgba(0, 0, 0, 0.7); }\n .button.is-success:focus:not(:active), .button.is-success.is-focused:not(:active) {\n box-shadow: 0 0 0 0.125em rgba(17, 173, 116, 0.25); }\n .button.is-success:active, .button.is-success.is-active {\n background-color: #0f9564;\n border-color: transparent;\n color: rgba(0, 0, 0, 0.7); }\n .button.is-success[disabled], fieldset[disabled] .button.is-success {\n background-color: #11ad74;\n border-color: transparent;\n box-shadow: none; }\n .button.is-success.is-inverted {\n background-color: rgba(0, 0, 0, 0.7);\n color: #11ad74; }\n .button.is-success.is-inverted:hover {\n background-color: rgba(0, 0, 0, 0.7); }\n .button.is-success.is-inverted[disabled], fieldset[disabled] .button.is-success.is-inverted {\n background-color: rgba(0, 0, 0, 0.7);\n border-color: transparent;\n box-shadow: none;\n color: #11ad74; }\n .button.is-success.is-loading::after {\n border-color: transparent transparent rgba(0, 0, 0, 0.7) rgba(0, 0, 0, 0.7) !important; }\n .button.is-success.is-outlined {\n background-color: transparent;\n border-color: #11ad74;\n color: #11ad74; }\n .button.is-success.is-outlined:hover, .button.is-success.is-outlined:focus {\n background-color: #11ad74;\n border-color: #11ad74;\n color: rgba(0, 0, 0, 0.7); }\n .button.is-success.is-outlined.is-loading::after {\n border-color: transparent transparent #11ad74 #11ad74 !important; }\n .button.is-success.is-outlined[disabled], fieldset[disabled] .button.is-success.is-outlined {\n background-color: transparent;\n border-color: #11ad74;\n box-shadow: none;\n color: #11ad74; }\n .button.is-success.is-inverted.is-outlined {\n background-color: transparent;\n border-color: rgba(0, 0, 0, 0.7);\n color: rgba(0, 0, 0, 0.7); }\n .button.is-success.is-inverted.is-outlined:hover, .button.is-success.is-inverted.is-outlined:focus {\n background-color: rgba(0, 0, 0, 0.7);\n color: #11ad74; }\n .button.is-success.is-inverted.is-outlined[disabled], fieldset[disabled] .button.is-success.is-inverted.is-outlined {\n background-color: transparent;\n border-color: rgba(0, 0, 0, 0.7);\n box-shadow: none;\n color: rgba(0, 0, 0, 0.7); }\n .button.is-warning {\n background-color: #ccba00;\n border-color: transparent;\n color: rgba(0, 0, 0, 0.7); }\n .button.is-warning:hover, .button.is-warning.is-hovered {\n background-color: #bfaf00;\n border-color: transparent;\n color: rgba(0, 0, 0, 0.7); }\n .button.is-warning:focus, .button.is-warning.is-focused {\n border-color: transparent;\n color: rgba(0, 0, 0, 0.7); }\n .button.is-warning:focus:not(:active), .button.is-warning.is-focused:not(:active) {\n box-shadow: 0 0 0 0.125em rgba(204, 186, 0, 0.25); }\n .button.is-warning:active, .button.is-warning.is-active {\n background-color: #b3a300;\n border-color: transparent;\n color: rgba(0, 0, 0, 0.7); }\n .button.is-warning[disabled], fieldset[disabled] .button.is-warning {\n background-color: #ccba00;\n border-color: transparent;\n box-shadow: none; }\n .button.is-warning.is-inverted {\n background-color: rgba(0, 0, 0, 0.7);\n color: #ccba00; }\n .button.is-warning.is-inverted:hover {\n background-color: rgba(0, 0, 0, 0.7); }\n .button.is-warning.is-inverted[disabled], fieldset[disabled] .button.is-warning.is-inverted {\n background-color: rgba(0, 0, 0, 0.7);\n border-color: transparent;\n box-shadow: none;\n color: #ccba00; }\n .button.is-warning.is-loading::after {\n border-color: transparent transparent rgba(0, 0, 0, 0.7) rgba(0, 0, 0, 0.7) !important; }\n .button.is-warning.is-outlined {\n background-color: transparent;\n border-color: #ccba00;\n color: #ccba00; }\n .button.is-warning.is-outlined:hover, .button.is-warning.is-outlined:focus {\n background-color: #ccba00;\n border-color: #ccba00;\n color: rgba(0, 0, 0, 0.7); }\n .button.is-warning.is-outlined.is-loading::after {\n border-color: transparent transparent #ccba00 #ccba00 !important; }\n .button.is-warning.is-outlined[disabled], fieldset[disabled] .button.is-warning.is-outlined {\n background-color: transparent;\n border-color: #ccba00;\n box-shadow: none;\n color: #ccba00; }\n .button.is-warning.is-inverted.is-outlined {\n background-color: transparent;\n border-color: rgba(0, 0, 0, 0.7);\n color: rgba(0, 0, 0, 0.7); }\n .button.is-warning.is-inverted.is-outlined:hover, .button.is-warning.is-inverted.is-outlined:focus {\n background-color: rgba(0, 0, 0, 0.7);\n color: #ccba00; }\n .button.is-warning.is-inverted.is-outlined[disabled], fieldset[disabled] .button.is-warning.is-inverted.is-outlined {\n background-color: transparent;\n border-color: rgba(0, 0, 0, 0.7);\n box-shadow: none;\n color: rgba(0, 0, 0, 0.7); }\n .button.is-danger {\n background-color: #ee1742;\n border-color: transparent;\n color: #fff; }\n .button.is-danger:hover, .button.is-danger.is-hovered {\n background-color: #e6113c;\n border-color: transparent;\n color: #fff; }\n .button.is-danger:focus, .button.is-danger.is-focused {\n border-color: transparent;\n color: #fff; }\n .button.is-danger:focus:not(:active), .button.is-danger.is-focused:not(:active) {\n box-shadow: 0 0 0 0.125em rgba(238, 23, 66, 0.25); }\n .button.is-danger:active, .button.is-danger.is-active {\n background-color: #da1039;\n border-color: transparent;\n color: #fff; }\n .button.is-danger[disabled], fieldset[disabled] .button.is-danger {\n background-color: #ee1742;\n border-color: transparent;\n box-shadow: none; }\n .button.is-danger.is-inverted {\n background-color: #fff;\n color: #ee1742; }\n .button.is-danger.is-inverted:hover {\n background-color: #f2f2f2; }\n .button.is-danger.is-inverted[disabled], fieldset[disabled] .button.is-danger.is-inverted {\n background-color: #fff;\n border-color: transparent;\n box-shadow: none;\n color: #ee1742; }\n .button.is-danger.is-loading::after {\n border-color: transparent transparent #fff #fff !important; }\n .button.is-danger.is-outlined {\n background-color: transparent;\n border-color: #ee1742;\n color: #ee1742; }\n .button.is-danger.is-outlined:hover, .button.is-danger.is-outlined:focus {\n background-color: #ee1742;\n border-color: #ee1742;\n color: #fff; }\n .button.is-danger.is-outlined.is-loading::after {\n border-color: transparent transparent #ee1742 #ee1742 !important; }\n .button.is-danger.is-outlined[disabled], fieldset[disabled] .button.is-danger.is-outlined {\n background-color: transparent;\n border-color: #ee1742;\n box-shadow: none;\n color: #ee1742; }\n .button.is-danger.is-inverted.is-outlined {\n background-color: transparent;\n border-color: #fff;\n color: #fff; }\n .button.is-danger.is-inverted.is-outlined:hover, .button.is-danger.is-inverted.is-outlined:focus {\n background-color: #fff;\n color: #ee1742; }\n .button.is-danger.is-inverted.is-outlined[disabled], fieldset[disabled] .button.is-danger.is-inverted.is-outlined {\n background-color: transparent;\n border-color: #fff;\n box-shadow: none;\n color: #fff; }\n .button.is-white-dark {\n background-color: white;\n border-color: transparent;\n color: #0a0a0a; }\n .button.is-white-dark:hover, .button.is-white-dark.is-hovered {\n background-color: #f9f9f9;\n border-color: transparent;\n color: #0a0a0a; }\n .button.is-white-dark:focus, .button.is-white-dark.is-focused {\n border-color: transparent;\n color: #0a0a0a; }\n .button.is-white-dark:focus:not(:active), .button.is-white-dark.is-focused:not(:active) {\n box-shadow: 0 0 0 0.125em rgba(255, 255, 255, 0.25); }\n .button.is-white-dark:active, .button.is-white-dark.is-active {\n background-color: #f2f2f2;\n border-color: transparent;\n color: #0a0a0a; }\n .button.is-white-dark[disabled], fieldset[disabled] .button.is-white-dark {\n background-color: white;\n border-color: transparent;\n box-shadow: none; }\n .button.is-white-dark.is-inverted {\n background-color: #0a0a0a;\n color: white; }\n .button.is-white-dark.is-inverted:hover {\n background-color: black; }\n .button.is-white-dark.is-inverted[disabled], fieldset[disabled] .button.is-white-dark.is-inverted {\n background-color: #0a0a0a;\n border-color: transparent;\n box-shadow: none;\n color: white; }\n .button.is-white-dark.is-loading::after {\n border-color: transparent transparent #0a0a0a #0a0a0a !important; }\n .button.is-white-dark.is-outlined {\n background-color: transparent;\n border-color: white;\n color: white; }\n .button.is-white-dark.is-outlined:hover, .button.is-white-dark.is-outlined:focus {\n background-color: white;\n border-color: white;\n color: #0a0a0a; }\n .button.is-white-dark.is-outlined.is-loading::after {\n border-color: transparent transparent white white !important; }\n .button.is-white-dark.is-outlined[disabled], fieldset[disabled] .button.is-white-dark.is-outlined {\n background-color: transparent;\n border-color: white;\n box-shadow: none;\n color: white; }\n .button.is-white-dark.is-inverted.is-outlined {\n background-color: transparent;\n border-color: #0a0a0a;\n color: #0a0a0a; }\n .button.is-white-dark.is-inverted.is-outlined:hover, .button.is-white-dark.is-inverted.is-outlined:focus {\n background-color: #0a0a0a;\n color: white; }\n .button.is-white-dark.is-inverted.is-outlined[disabled], fieldset[disabled] .button.is-white-dark.is-inverted.is-outlined {\n background-color: transparent;\n border-color: #0a0a0a;\n box-shadow: none;\n color: #0a0a0a; }\n .button.is-black-dark {\n background-color: #0a0a0a;\n border-color: transparent;\n color: white; }\n .button.is-black-dark:hover, .button.is-black-dark.is-hovered {\n background-color: #040404;\n border-color: transparent;\n color: white; }\n .button.is-black-dark:focus, .button.is-black-dark.is-focused {\n border-color: transparent;\n color: white; }\n .button.is-black-dark:focus:not(:active), .button.is-black-dark.is-focused:not(:active) {\n box-shadow: 0 0 0 0.125em rgba(10, 10, 10, 0.25); }\n .button.is-black-dark:active, .button.is-black-dark.is-active {\n background-color: black;\n border-color: transparent;\n color: white; }\n .button.is-black-dark[disabled], fieldset[disabled] .button.is-black-dark {\n background-color: #0a0a0a;\n border-color: transparent;\n box-shadow: none; }\n .button.is-black-dark.is-inverted {\n background-color: white;\n color: #0a0a0a; }\n .button.is-black-dark.is-inverted:hover {\n background-color: #f2f2f2; }\n .button.is-black-dark.is-inverted[disabled], fieldset[disabled] .button.is-black-dark.is-inverted {\n background-color: white;\n border-color: transparent;\n box-shadow: none;\n color: #0a0a0a; }\n .button.is-black-dark.is-loading::after {\n border-color: transparent transparent white white !important; }\n .button.is-black-dark.is-outlined {\n background-color: transparent;\n border-color: #0a0a0a;\n color: #0a0a0a; }\n .button.is-black-dark.is-outlined:hover, .button.is-black-dark.is-outlined:focus {\n background-color: #0a0a0a;\n border-color: #0a0a0a;\n color: white; }\n .button.is-black-dark.is-outlined.is-loading::after {\n border-color: transparent transparent #0a0a0a #0a0a0a !important; }\n .button.is-black-dark.is-outlined[disabled], fieldset[disabled] .button.is-black-dark.is-outlined {\n background-color: transparent;\n border-color: #0a0a0a;\n box-shadow: none;\n color: #0a0a0a; }\n .button.is-black-dark.is-inverted.is-outlined {\n background-color: transparent;\n border-color: white;\n color: white; }\n .button.is-black-dark.is-inverted.is-outlined:hover, .button.is-black-dark.is-inverted.is-outlined:focus {\n background-color: white;\n color: #0a0a0a; }\n .button.is-black-dark.is-inverted.is-outlined[disabled], fieldset[disabled] .button.is-black-dark.is-inverted.is-outlined {\n background-color: transparent;\n border-color: white;\n box-shadow: none;\n color: white; }\n .button.is-light-dark {\n background-color: whitesmoke;\n border-color: transparent;\n color: rgba(0, 0, 0, 0.7); }\n .button.is-light-dark:hover, .button.is-light-dark.is-hovered {\n background-color: #eeeeee;\n border-color: transparent;\n color: rgba(0, 0, 0, 0.7); }\n .button.is-light-dark:focus, .button.is-light-dark.is-focused {\n border-color: transparent;\n color: rgba(0, 0, 0, 0.7); }\n .button.is-light-dark:focus:not(:active), .button.is-light-dark.is-focused:not(:active) {\n box-shadow: 0 0 0 0.125em rgba(245, 245, 245, 0.25); }\n .button.is-light-dark:active, .button.is-light-dark.is-active {\n background-color: #e8e8e8;\n border-color: transparent;\n color: rgba(0, 0, 0, 0.7); }\n .button.is-light-dark[disabled], fieldset[disabled] .button.is-light-dark {\n background-color: whitesmoke;\n border-color: transparent;\n box-shadow: none; }\n .button.is-light-dark.is-inverted {\n background-color: rgba(0, 0, 0, 0.7);\n color: whitesmoke; }\n .button.is-light-dark.is-inverted:hover {\n background-color: rgba(0, 0, 0, 0.7); }\n .button.is-light-dark.is-inverted[disabled], fieldset[disabled] .button.is-light-dark.is-inverted {\n background-color: rgba(0, 0, 0, 0.7);\n border-color: transparent;\n box-shadow: none;\n color: whitesmoke; }\n .button.is-light-dark.is-loading::after {\n border-color: transparent transparent rgba(0, 0, 0, 0.7) rgba(0, 0, 0, 0.7) !important; }\n .button.is-light-dark.is-outlined {\n background-color: transparent;\n border-color: whitesmoke;\n color: whitesmoke; }\n .button.is-light-dark.is-outlined:hover, .button.is-light-dark.is-outlined:focus {\n background-color: whitesmoke;\n border-color: whitesmoke;\n color: rgba(0, 0, 0, 0.7); }\n .button.is-light-dark.is-outlined.is-loading::after {\n border-color: transparent transparent whitesmoke whitesmoke !important; }\n .button.is-light-dark.is-outlined[disabled], fieldset[disabled] .button.is-light-dark.is-outlined {\n background-color: transparent;\n border-color: whitesmoke;\n box-shadow: none;\n color: whitesmoke; }\n .button.is-light-dark.is-inverted.is-outlined {\n background-color: transparent;\n border-color: rgba(0, 0, 0, 0.7);\n color: rgba(0, 0, 0, 0.7); }\n .button.is-light-dark.is-inverted.is-outlined:hover, .button.is-light-dark.is-inverted.is-outlined:focus {\n background-color: rgba(0, 0, 0, 0.7);\n color: whitesmoke; }\n .button.is-light-dark.is-inverted.is-outlined[disabled], fieldset[disabled] .button.is-light-dark.is-inverted.is-outlined {\n background-color: transparent;\n border-color: rgba(0, 0, 0, 0.7);\n box-shadow: none;\n color: rgba(0, 0, 0, 0.7); }\n .button.is-dark-dark {\n background-color: #363636;\n border-color: transparent;\n color: #fff; }\n .button.is-dark-dark:hover, .button.is-dark-dark.is-hovered {\n background-color: #2f2f2f;\n border-color: transparent;\n color: #fff; }\n .button.is-dark-dark:focus, .button.is-dark-dark.is-focused {\n border-color: transparent;\n color: #fff; }\n .button.is-dark-dark:focus:not(:active), .button.is-dark-dark.is-focused:not(:active) {\n box-shadow: 0 0 0 0.125em rgba(54, 54, 54, 0.25); }\n .button.is-dark-dark:active, .button.is-dark-dark.is-active {\n background-color: #292929;\n border-color: transparent;\n color: #fff; }\n .button.is-dark-dark[disabled], fieldset[disabled] .button.is-dark-dark {\n background-color: #363636;\n border-color: transparent;\n box-shadow: none; }\n .button.is-dark-dark.is-inverted {\n background-color: #fff;\n color: #363636; }\n .button.is-dark-dark.is-inverted:hover {\n background-color: #f2f2f2; }\n .button.is-dark-dark.is-inverted[disabled], fieldset[disabled] .button.is-dark-dark.is-inverted {\n background-color: #fff;\n border-color: transparent;\n box-shadow: none;\n color: #363636; }\n .button.is-dark-dark.is-loading::after {\n border-color: transparent transparent #fff #fff !important; }\n .button.is-dark-dark.is-outlined {\n background-color: transparent;\n border-color: #363636;\n color: #363636; }\n .button.is-dark-dark.is-outlined:hover, .button.is-dark-dark.is-outlined:focus {\n background-color: #363636;\n border-color: #363636;\n color: #fff; }\n .button.is-dark-dark.is-outlined.is-loading::after {\n border-color: transparent transparent #363636 #363636 !important; }\n .button.is-dark-dark.is-outlined[disabled], fieldset[disabled] .button.is-dark-dark.is-outlined {\n background-color: transparent;\n border-color: #363636;\n box-shadow: none;\n color: #363636; }\n .button.is-dark-dark.is-inverted.is-outlined {\n background-color: transparent;\n border-color: #fff;\n color: #fff; }\n .button.is-dark-dark.is-inverted.is-outlined:hover, .button.is-dark-dark.is-inverted.is-outlined:focus {\n background-color: #fff;\n color: #363636; }\n .button.is-dark-dark.is-inverted.is-outlined[disabled], fieldset[disabled] .button.is-dark-dark.is-inverted.is-outlined {\n background-color: transparent;\n border-color: #fff;\n box-shadow: none;\n color: #fff; }\n .button.is-primary-dark {\n background-color: #ff0d68;\n border-color: transparent;\n color: #fff; }\n .button.is-primary-dark:hover, .button.is-primary-dark.is-hovered {\n background-color: #ff0060;\n border-color: transparent;\n color: #fff; }\n .button.is-primary-dark:focus, .button.is-primary-dark.is-focused {\n border-color: transparent;\n color: #fff; }\n .button.is-primary-dark:focus:not(:active), .button.is-primary-dark.is-focused:not(:active) {\n box-shadow: 0 0 0 0.125em rgba(255, 13, 104, 0.25); }\n .button.is-primary-dark:active, .button.is-primary-dark.is-active {\n background-color: #f3005b;\n border-color: transparent;\n color: #fff; }\n .button.is-primary-dark[disabled], fieldset[disabled] .button.is-primary-dark {\n background-color: #ff0d68;\n border-color: transparent;\n box-shadow: none; }\n .button.is-primary-dark.is-inverted {\n background-color: #fff;\n color: #ff0d68; }\n .button.is-primary-dark.is-inverted:hover {\n background-color: #f2f2f2; }\n .button.is-primary-dark.is-inverted[disabled], fieldset[disabled] .button.is-primary-dark.is-inverted {\n background-color: #fff;\n border-color: transparent;\n box-shadow: none;\n color: #ff0d68; }\n .button.is-primary-dark.is-loading::after {\n border-color: transparent transparent #fff #fff !important; }\n .button.is-primary-dark.is-outlined {\n background-color: transparent;\n border-color: #ff0d68;\n color: #ff0d68; }\n .button.is-primary-dark.is-outlined:hover, .button.is-primary-dark.is-outlined:focus {\n background-color: #ff0d68;\n border-color: #ff0d68;\n color: #fff; }\n .button.is-primary-dark.is-outlined.is-loading::after {\n border-color: transparent transparent #ff0d68 #ff0d68 !important; }\n .button.is-primary-dark.is-outlined[disabled], fieldset[disabled] .button.is-primary-dark.is-outlined {\n background-color: transparent;\n border-color: #ff0d68;\n box-shadow: none;\n color: #ff0d68; }\n .button.is-primary-dark.is-inverted.is-outlined {\n background-color: transparent;\n border-color: #fff;\n color: #fff; }\n .button.is-primary-dark.is-inverted.is-outlined:hover, .button.is-primary-dark.is-inverted.is-outlined:focus {\n background-color: #fff;\n color: #ff0d68; }\n .button.is-primary-dark.is-inverted.is-outlined[disabled], fieldset[disabled] .button.is-primary-dark.is-inverted.is-outlined {\n background-color: transparent;\n border-color: #fff;\n box-shadow: none;\n color: #fff; }\n .button.is-link-dark {\n background-color: #ff0d68;\n border-color: transparent;\n color: #fff; }\n .button.is-link-dark:hover, .button.is-link-dark.is-hovered {\n background-color: #ff0060;\n border-color: transparent;\n color: #fff; }\n .button.is-link-dark:focus, .button.is-link-dark.is-focused {\n border-color: transparent;\n color: #fff; }\n .button.is-link-dark:focus:not(:active), .button.is-link-dark.is-focused:not(:active) {\n box-shadow: 0 0 0 0.125em rgba(255, 13, 104, 0.25); }\n .button.is-link-dark:active, .button.is-link-dark.is-active {\n background-color: #f3005b;\n border-color: transparent;\n color: #fff; }\n .button.is-link-dark[disabled], fieldset[disabled] .button.is-link-dark {\n background-color: #ff0d68;\n border-color: transparent;\n box-shadow: none; }\n .button.is-link-dark.is-inverted {\n background-color: #fff;\n color: #ff0d68; }\n .button.is-link-dark.is-inverted:hover {\n background-color: #f2f2f2; }\n .button.is-link-dark.is-inverted[disabled], fieldset[disabled] .button.is-link-dark.is-inverted {\n background-color: #fff;\n border-color: transparent;\n box-shadow: none;\n color: #ff0d68; }\n .button.is-link-dark.is-loading::after {\n border-color: transparent transparent #fff #fff !important; }\n .button.is-link-dark.is-outlined {\n background-color: transparent;\n border-color: #ff0d68;\n color: #ff0d68; }\n .button.is-link-dark.is-outlined:hover, .button.is-link-dark.is-outlined:focus {\n background-color: #ff0d68;\n border-color: #ff0d68;\n color: #fff; }\n .button.is-link-dark.is-outlined.is-loading::after {\n border-color: transparent transparent #ff0d68 #ff0d68 !important; }\n .button.is-link-dark.is-outlined[disabled], fieldset[disabled] .button.is-link-dark.is-outlined {\n background-color: transparent;\n border-color: #ff0d68;\n box-shadow: none;\n color: #ff0d68; }\n .button.is-link-dark.is-inverted.is-outlined {\n background-color: transparent;\n border-color: #fff;\n color: #fff; }\n .button.is-link-dark.is-inverted.is-outlined:hover, .button.is-link-dark.is-inverted.is-outlined:focus {\n background-color: #fff;\n color: #ff0d68; }\n .button.is-link-dark.is-inverted.is-outlined[disabled], fieldset[disabled] .button.is-link-dark.is-inverted.is-outlined {\n background-color: transparent;\n border-color: #fff;\n box-shadow: none;\n color: #fff; }\n .button.is-info-dark {\n background-color: #0092FF;\n border-color: transparent;\n color: #fff; }\n .button.is-info-dark:hover, .button.is-info-dark.is-hovered {\n background-color: #008bf2;\n border-color: transparent;\n color: #fff; }\n .button.is-info-dark:focus, .button.is-info-dark.is-focused {\n border-color: transparent;\n color: #fff; }\n .button.is-info-dark:focus:not(:active), .button.is-info-dark.is-focused:not(:active) {\n box-shadow: 0 0 0 0.125em rgba(0, 146, 255, 0.25); }\n .button.is-info-dark:active, .button.is-info-dark.is-active {\n background-color: #0083e6;\n border-color: transparent;\n color: #fff; }\n .button.is-info-dark[disabled], fieldset[disabled] .button.is-info-dark {\n background-color: #0092FF;\n border-color: transparent;\n box-shadow: none; }\n .button.is-info-dark.is-inverted {\n background-color: #fff;\n color: #0092FF; }\n .button.is-info-dark.is-inverted:hover {\n background-color: #f2f2f2; }\n .button.is-info-dark.is-inverted[disabled], fieldset[disabled] .button.is-info-dark.is-inverted {\n background-color: #fff;\n border-color: transparent;\n box-shadow: none;\n color: #0092FF; }\n .button.is-info-dark.is-loading::after {\n border-color: transparent transparent #fff #fff !important; }\n .button.is-info-dark.is-outlined {\n background-color: transparent;\n border-color: #0092FF;\n color: #0092FF; }\n .button.is-info-dark.is-outlined:hover, .button.is-info-dark.is-outlined:focus {\n background-color: #0092FF;\n border-color: #0092FF;\n color: #fff; }\n .button.is-info-dark.is-outlined.is-loading::after {\n border-color: transparent transparent #0092FF #0092FF !important; }\n .button.is-info-dark.is-outlined[disabled], fieldset[disabled] .button.is-info-dark.is-outlined {\n background-color: transparent;\n border-color: #0092FF;\n box-shadow: none;\n color: #0092FF; }\n .button.is-info-dark.is-inverted.is-outlined {\n background-color: transparent;\n border-color: #fff;\n color: #fff; }\n .button.is-info-dark.is-inverted.is-outlined:hover, .button.is-info-dark.is-inverted.is-outlined:focus {\n background-color: #fff;\n color: #0092FF; }\n .button.is-info-dark.is-inverted.is-outlined[disabled], fieldset[disabled] .button.is-info-dark.is-inverted.is-outlined {\n background-color: transparent;\n border-color: #fff;\n box-shadow: none;\n color: #fff; }\n .button.is-success-dark {\n background-color: #16DB93;\n border-color: transparent;\n color: rgba(0, 0, 0, 0.7); }\n .button.is-success-dark:hover, .button.is-success-dark.is-hovered {\n background-color: #15cf8b;\n border-color: transparent;\n color: rgba(0, 0, 0, 0.7); }\n .button.is-success-dark:focus, .button.is-success-dark.is-focused {\n border-color: transparent;\n color: rgba(0, 0, 0, 0.7); }\n .button.is-success-dark:focus:not(:active), .button.is-success-dark.is-focused:not(:active) {\n box-shadow: 0 0 0 0.125em rgba(22, 219, 147, 0.25); }\n .button.is-success-dark:active, .button.is-success-dark.is-active {\n background-color: #14c483;\n border-color: transparent;\n color: rgba(0, 0, 0, 0.7); }\n .button.is-success-dark[disabled], fieldset[disabled] .button.is-success-dark {\n background-color: #16DB93;\n border-color: transparent;\n box-shadow: none; }\n .button.is-success-dark.is-inverted {\n background-color: rgba(0, 0, 0, 0.7);\n color: #16DB93; }\n .button.is-success-dark.is-inverted:hover {\n background-color: rgba(0, 0, 0, 0.7); }\n .button.is-success-dark.is-inverted[disabled], fieldset[disabled] .button.is-success-dark.is-inverted {\n background-color: rgba(0, 0, 0, 0.7);\n border-color: transparent;\n box-shadow: none;\n color: #16DB93; }\n .button.is-success-dark.is-loading::after {\n border-color: transparent transparent rgba(0, 0, 0, 0.7) rgba(0, 0, 0, 0.7) !important; }\n .button.is-success-dark.is-outlined {\n background-color: transparent;\n border-color: #16DB93;\n color: #16DB93; }\n .button.is-success-dark.is-outlined:hover, .button.is-success-dark.is-outlined:focus {\n background-color: #16DB93;\n border-color: #16DB93;\n color: rgba(0, 0, 0, 0.7); }\n .button.is-success-dark.is-outlined.is-loading::after {\n border-color: transparent transparent #16DB93 #16DB93 !important; }\n .button.is-success-dark.is-outlined[disabled], fieldset[disabled] .button.is-success-dark.is-outlined {\n background-color: transparent;\n border-color: #16DB93;\n box-shadow: none;\n color: #16DB93; }\n .button.is-success-dark.is-inverted.is-outlined {\n background-color: transparent;\n border-color: rgba(0, 0, 0, 0.7);\n color: rgba(0, 0, 0, 0.7); }\n .button.is-success-dark.is-inverted.is-outlined:hover, .button.is-success-dark.is-inverted.is-outlined:focus {\n background-color: rgba(0, 0, 0, 0.7);\n color: #16DB93; }\n .button.is-success-dark.is-inverted.is-outlined[disabled], fieldset[disabled] .button.is-success-dark.is-inverted.is-outlined {\n background-color: transparent;\n border-color: rgba(0, 0, 0, 0.7);\n box-shadow: none;\n color: rgba(0, 0, 0, 0.7); }\n .button.is-warning-dark {\n background-color: #FFE900;\n border-color: transparent;\n color: rgba(0, 0, 0, 0.7); }\n .button.is-warning-dark:hover, .button.is-warning-dark.is-hovered {\n background-color: #f2dd00;\n border-color: transparent;\n color: rgba(0, 0, 0, 0.7); }\n .button.is-warning-dark:focus, .button.is-warning-dark.is-focused {\n border-color: transparent;\n color: rgba(0, 0, 0, 0.7); }\n .button.is-warning-dark:focus:not(:active), .button.is-warning-dark.is-focused:not(:active) {\n box-shadow: 0 0 0 0.125em rgba(255, 233, 0, 0.25); }\n .button.is-warning-dark:active, .button.is-warning-dark.is-active {\n background-color: #e6d200;\n border-color: transparent;\n color: rgba(0, 0, 0, 0.7); }\n .button.is-warning-dark[disabled], fieldset[disabled] .button.is-warning-dark {\n background-color: #FFE900;\n border-color: transparent;\n box-shadow: none; }\n .button.is-warning-dark.is-inverted {\n background-color: rgba(0, 0, 0, 0.7);\n color: #FFE900; }\n .button.is-warning-dark.is-inverted:hover {\n background-color: rgba(0, 0, 0, 0.7); }\n .button.is-warning-dark.is-inverted[disabled], fieldset[disabled] .button.is-warning-dark.is-inverted {\n background-color: rgba(0, 0, 0, 0.7);\n border-color: transparent;\n box-shadow: none;\n color: #FFE900; }\n .button.is-warning-dark.is-loading::after {\n border-color: transparent transparent rgba(0, 0, 0, 0.7) rgba(0, 0, 0, 0.7) !important; }\n .button.is-warning-dark.is-outlined {\n background-color: transparent;\n border-color: #FFE900;\n color: #FFE900; }\n .button.is-warning-dark.is-outlined:hover, .button.is-warning-dark.is-outlined:focus {\n background-color: #FFE900;\n border-color: #FFE900;\n color: rgba(0, 0, 0, 0.7); }\n .button.is-warning-dark.is-outlined.is-loading::after {\n border-color: transparent transparent #FFE900 #FFE900 !important; }\n .button.is-warning-dark.is-outlined[disabled], fieldset[disabled] .button.is-warning-dark.is-outlined {\n background-color: transparent;\n border-color: #FFE900;\n box-shadow: none;\n color: #FFE900; }\n .button.is-warning-dark.is-inverted.is-outlined {\n background-color: transparent;\n border-color: rgba(0, 0, 0, 0.7);\n color: rgba(0, 0, 0, 0.7); }\n .button.is-warning-dark.is-inverted.is-outlined:hover, .button.is-warning-dark.is-inverted.is-outlined:focus {\n background-color: rgba(0, 0, 0, 0.7);\n color: #FFE900; }\n .button.is-warning-dark.is-inverted.is-outlined[disabled], fieldset[disabled] .button.is-warning-dark.is-inverted.is-outlined {\n background-color: transparent;\n border-color: rgba(0, 0, 0, 0.7);\n box-shadow: none;\n color: rgba(0, 0, 0, 0.7); }\n .button.is-danger-dark {\n background-color: #f14668;\n border-color: transparent;\n color: #fff; }\n .button.is-danger-dark:hover, .button.is-danger-dark.is-hovered {\n background-color: #f03a5f;\n border-color: transparent;\n color: #fff; }\n .button.is-danger-dark:focus, .button.is-danger-dark.is-focused {\n border-color: transparent;\n color: #fff; }\n .button.is-danger-dark:focus:not(:active), .button.is-danger-dark.is-focused:not(:active) {\n box-shadow: 0 0 0 0.125em rgba(241, 70, 104, 0.25); }\n .button.is-danger-dark:active, .button.is-danger-dark.is-active {\n background-color: #ef2e55;\n border-color: transparent;\n color: #fff; }\n .button.is-danger-dark[disabled], fieldset[disabled] .button.is-danger-dark {\n background-color: #f14668;\n border-color: transparent;\n box-shadow: none; }\n .button.is-danger-dark.is-inverted {\n background-color: #fff;\n color: #f14668; }\n .button.is-danger-dark.is-inverted:hover {\n background-color: #f2f2f2; }\n .button.is-danger-dark.is-inverted[disabled], fieldset[disabled] .button.is-danger-dark.is-inverted {\n background-color: #fff;\n border-color: transparent;\n box-shadow: none;\n color: #f14668; }\n .button.is-danger-dark.is-loading::after {\n border-color: transparent transparent #fff #fff !important; }\n .button.is-danger-dark.is-outlined {\n background-color: transparent;\n border-color: #f14668;\n color: #f14668; }\n .button.is-danger-dark.is-outlined:hover, .button.is-danger-dark.is-outlined:focus {\n background-color: #f14668;\n border-color: #f14668;\n color: #fff; }\n .button.is-danger-dark.is-outlined.is-loading::after {\n border-color: transparent transparent #f14668 #f14668 !important; }\n .button.is-danger-dark.is-outlined[disabled], fieldset[disabled] .button.is-danger-dark.is-outlined {\n background-color: transparent;\n border-color: #f14668;\n box-shadow: none;\n color: #f14668; }\n .button.is-danger-dark.is-inverted.is-outlined {\n background-color: transparent;\n border-color: #fff;\n color: #fff; }\n .button.is-danger-dark.is-inverted.is-outlined:hover, .button.is-danger-dark.is-inverted.is-outlined:focus {\n background-color: #fff;\n color: #f14668; }\n .button.is-danger-dark.is-inverted.is-outlined[disabled], fieldset[disabled] .button.is-danger-dark.is-inverted.is-outlined {\n background-color: transparent;\n border-color: #fff;\n box-shadow: none;\n color: #fff; }\n .button[disabled], fieldset[disabled] .button {\n background-color: #0a0a0a;\n border-color: #363636; }\n .button.is-static {\n background-color: whitesmoke;\n border-color: #363636;\n color: #7a7a7a; }\n .content h1,\n .content h2,\n .content h3,\n .content h4,\n .content h5,\n .content h6 {\n color: #dbdbdb; }\n .content blockquote {\n background-color: #242424;\n border-left: 5px solid #363636; }\n .content table td,\n .content table th {\n border: 1px solid #363636; }\n .content table th {\n color: #dbdbdb; }\n .content table thead td,\n .content table thead th {\n color: #dbdbdb; }\n .content table tfoot td,\n .content table tfoot th {\n color: #dbdbdb; }\n .input,\n .textarea {\n background-color: #0a0a0a;\n border-color: #363636;\n color: #dbdbdb;\n box-shadow: inset 0 1px 2px rgba(255, 255, 255, 0.1); }\n .input::-moz-placeholder,\n .textarea::-moz-placeholder {\n color: rgba(219, 219, 219, 0.3); }\n .input::-webkit-input-placeholder,\n .textarea::-webkit-input-placeholder {\n color: rgba(219, 219, 219, 0.3); }\n .input:-moz-placeholder,\n .textarea:-moz-placeholder {\n color: rgba(219, 219, 219, 0.3); }\n .input:-ms-input-placeholder,\n .textarea:-ms-input-placeholder {\n color: rgba(219, 219, 219, 0.3); }\n .input:hover, .input.is-hovered,\n .textarea:hover,\n .textarea.is-hovered {\n border-color: #4a4a4a; }\n .input:focus, .input.is-focused, .input:active, .input.is-active,\n .textarea:focus,\n .textarea.is-focused,\n .textarea:active,\n .textarea.is-active {\n border-color: #e60056;\n box-shadow: 0 0 0 0.125em rgba(230, 0, 86, 0.25); }\n .input[disabled], fieldset[disabled] .input,\n .textarea[disabled], fieldset[disabled] .textarea {\n background-color: #242424;\n border-color: #242424;\n color: #b5b5b5; }\n .input[disabled]::-moz-placeholder, fieldset[disabled] .input::-moz-placeholder,\n .textarea[disabled]::-moz-placeholder, fieldset[disabled] .textarea::-moz-placeholder {\n color: rgba(181, 181, 181, 0.3); }\n .input[disabled]::-webkit-input-placeholder, fieldset[disabled] .input::-webkit-input-placeholder,\n .textarea[disabled]::-webkit-input-placeholder, fieldset[disabled] .textarea::-webkit-input-placeholder {\n color: rgba(181, 181, 181, 0.3); }\n .input[disabled]:-moz-placeholder, fieldset[disabled] .input:-moz-placeholder,\n .textarea[disabled]:-moz-placeholder, fieldset[disabled] .textarea:-moz-placeholder {\n color: rgba(181, 181, 181, 0.3); }\n .input[disabled]:-ms-input-placeholder, fieldset[disabled] .input:-ms-input-placeholder,\n .textarea[disabled]:-ms-input-placeholder, fieldset[disabled] .textarea:-ms-input-placeholder {\n color: rgba(181, 181, 181, 0.3); }\n .input.is-white,\n .textarea.is-white {\n border-color: #e6e6e6; }\n .input.is-white:focus, .input.is-white.is-focused, .input.is-white:active, .input.is-white.is-active,\n .textarea.is-white:focus,\n .textarea.is-white.is-focused,\n .textarea.is-white:active,\n .textarea.is-white.is-active {\n box-shadow: 0 0 0 0.125em rgba(230, 230, 230, 0.25); }\n .input.is-black,\n .textarea.is-black {\n border-color: black; }\n .input.is-black:focus, .input.is-black.is-focused, .input.is-black:active, .input.is-black.is-active,\n .textarea.is-black:focus,\n .textarea.is-black.is-focused,\n .textarea.is-black:active,\n .textarea.is-black.is-active {\n box-shadow: 0 0 0 0.125em rgba(0, 0, 0, 0.25); }\n .input.is-light,\n .textarea.is-light {\n border-color: #dbdbdb; }\n .input.is-light:focus, .input.is-light.is-focused, .input.is-light:active, .input.is-light.is-active,\n .textarea.is-light:focus,\n .textarea.is-light.is-focused,\n .textarea.is-light:active,\n .textarea.is-light.is-active {\n box-shadow: 0 0 0 0.125em rgba(219, 219, 219, 0.25); }\n .input.is-dark,\n .textarea.is-dark {\n border-color: #1c1c1c; }\n .input.is-dark:focus, .input.is-dark.is-focused, .input.is-dark:active, .input.is-dark.is-active,\n .textarea.is-dark:focus,\n .textarea.is-dark.is-focused,\n .textarea.is-dark:active,\n .textarea.is-dark.is-active {\n box-shadow: 0 0 0 0.125em rgba(28, 28, 28, 0.25); }\n .input.is-primary,\n .textarea.is-primary {\n border-color: #d90052; }\n .input.is-primary:focus, .input.is-primary.is-focused, .input.is-primary:active, .input.is-primary.is-active,\n .textarea.is-primary:focus,\n .textarea.is-primary.is-focused,\n .textarea.is-primary:active,\n .textarea.is-primary.is-active {\n box-shadow: 0 0 0 0.125em rgba(217, 0, 82, 0.25); }\n .input.is-link,\n .textarea.is-link {\n border-color: #d90052; }\n .input.is-link:focus, .input.is-link.is-focused, .input.is-link:active, .input.is-link.is-active,\n .textarea.is-link:focus,\n .textarea.is-link.is-focused,\n .textarea.is-link:active,\n .textarea.is-link.is-active {\n box-shadow: 0 0 0 0.125em rgba(217, 0, 82, 0.25); }\n .input.is-info,\n .textarea.is-info {\n border-color: #0075cc; }\n .input.is-info:focus, .input.is-info.is-focused, .input.is-info:active, .input.is-info.is-active,\n .textarea.is-info:focus,\n .textarea.is-info.is-focused,\n .textarea.is-info:active,\n .textarea.is-info.is-active {\n box-shadow: 0 0 0 0.125em rgba(0, 117, 204, 0.25); }\n .input.is-success,\n .textarea.is-success {\n border-color: #11ad74; }\n .input.is-success:focus, .input.is-success.is-focused, .input.is-success:active, .input.is-success.is-active,\n .textarea.is-success:focus,\n .textarea.is-success.is-focused,\n .textarea.is-success:active,\n .textarea.is-success.is-active {\n box-shadow: 0 0 0 0.125em rgba(17, 173, 116, 0.25); }\n .input.is-warning,\n .textarea.is-warning {\n border-color: #ccba00; }\n .input.is-warning:focus, .input.is-warning.is-focused, .input.is-warning:active, .input.is-warning.is-active,\n .textarea.is-warning:focus,\n .textarea.is-warning.is-focused,\n .textarea.is-warning:active,\n .textarea.is-warning.is-active {\n box-shadow: 0 0 0 0.125em rgba(204, 186, 0, 0.25); }\n .input.is-danger,\n .textarea.is-danger {\n border-color: #ee1742; }\n .input.is-danger:focus, .input.is-danger.is-focused, .input.is-danger:active, .input.is-danger.is-active,\n .textarea.is-danger:focus,\n .textarea.is-danger.is-focused,\n .textarea.is-danger:active,\n .textarea.is-danger.is-active {\n box-shadow: 0 0 0 0.125em rgba(238, 23, 66, 0.25); }\n .input.is-white-dark,\n .textarea.is-white-dark {\n border-color: white; }\n .input.is-white-dark:focus, .input.is-white-dark.is-focused, .input.is-white-dark:active, .input.is-white-dark.is-active,\n .textarea.is-white-dark:focus,\n .textarea.is-white-dark.is-focused,\n .textarea.is-white-dark:active,\n .textarea.is-white-dark.is-active {\n box-shadow: 0 0 0 0.125em rgba(255, 255, 255, 0.25); }\n .input.is-black-dark,\n .textarea.is-black-dark {\n border-color: #0a0a0a; }\n .input.is-black-dark:focus, .input.is-black-dark.is-focused, .input.is-black-dark:active, .input.is-black-dark.is-active,\n .textarea.is-black-dark:focus,\n .textarea.is-black-dark.is-focused,\n .textarea.is-black-dark:active,\n .textarea.is-black-dark.is-active {\n box-shadow: 0 0 0 0.125em rgba(10, 10, 10, 0.25); }\n .input.is-light-dark,\n .textarea.is-light-dark {\n border-color: whitesmoke; }\n .input.is-light-dark:focus, .input.is-light-dark.is-focused, .input.is-light-dark:active, .input.is-light-dark.is-active,\n .textarea.is-light-dark:focus,\n .textarea.is-light-dark.is-focused,\n .textarea.is-light-dark:active,\n .textarea.is-light-dark.is-active {\n box-shadow: 0 0 0 0.125em rgba(245, 245, 245, 0.25); }\n .input.is-dark-dark,\n .textarea.is-dark-dark {\n border-color: #363636; }\n .input.is-dark-dark:focus, .input.is-dark-dark.is-focused, .input.is-dark-dark:active, .input.is-dark-dark.is-active,\n .textarea.is-dark-dark:focus,\n .textarea.is-dark-dark.is-focused,\n .textarea.is-dark-dark:active,\n .textarea.is-dark-dark.is-active {\n box-shadow: 0 0 0 0.125em rgba(54, 54, 54, 0.25); }\n .input.is-primary-dark,\n .textarea.is-primary-dark {\n border-color: #ff0d68; }\n .input.is-primary-dark:focus, .input.is-primary-dark.is-focused, .input.is-primary-dark:active, .input.is-primary-dark.is-active,\n .textarea.is-primary-dark:focus,\n .textarea.is-primary-dark.is-focused,\n .textarea.is-primary-dark:active,\n .textarea.is-primary-dark.is-active {\n box-shadow: 0 0 0 0.125em rgba(255, 13, 104, 0.25); }\n .input.is-link-dark,\n .textarea.is-link-dark {\n border-color: #ff0d68; }\n .input.is-link-dark:focus, .input.is-link-dark.is-focused, .input.is-link-dark:active, .input.is-link-dark.is-active,\n .textarea.is-link-dark:focus,\n .textarea.is-link-dark.is-focused,\n .textarea.is-link-dark:active,\n .textarea.is-link-dark.is-active {\n box-shadow: 0 0 0 0.125em rgba(255, 13, 104, 0.25); }\n .input.is-info-dark,\n .textarea.is-info-dark {\n border-color: #0092FF; }\n .input.is-info-dark:focus, .input.is-info-dark.is-focused, .input.is-info-dark:active, .input.is-info-dark.is-active,\n .textarea.is-info-dark:focus,\n .textarea.is-info-dark.is-focused,\n .textarea.is-info-dark:active,\n .textarea.is-info-dark.is-active {\n box-shadow: 0 0 0 0.125em rgba(0, 146, 255, 0.25); }\n .input.is-success-dark,\n .textarea.is-success-dark {\n border-color: #16DB93; }\n .input.is-success-dark:focus, .input.is-success-dark.is-focused, .input.is-success-dark:active, .input.is-success-dark.is-active,\n .textarea.is-success-dark:focus,\n .textarea.is-success-dark.is-focused,\n .textarea.is-success-dark:active,\n .textarea.is-success-dark.is-active {\n box-shadow: 0 0 0 0.125em rgba(22, 219, 147, 0.25); }\n .input.is-warning-dark,\n .textarea.is-warning-dark {\n border-color: #FFE900; }\n .input.is-warning-dark:focus, .input.is-warning-dark.is-focused, .input.is-warning-dark:active, .input.is-warning-dark.is-active,\n .textarea.is-warning-dark:focus,\n .textarea.is-warning-dark.is-focused,\n .textarea.is-warning-dark:active,\n .textarea.is-warning-dark.is-active {\n box-shadow: 0 0 0 0.125em rgba(255, 233, 0, 0.25); }\n .input.is-danger-dark,\n .textarea.is-danger-dark {\n border-color: #f14668; }\n .input.is-danger-dark:focus, .input.is-danger-dark.is-focused, .input.is-danger-dark:active, .input.is-danger-dark.is-active,\n .textarea.is-danger-dark:focus,\n .textarea.is-danger-dark.is-focused,\n .textarea.is-danger-dark:active,\n .textarea.is-danger-dark.is-active {\n box-shadow: 0 0 0 0.125em rgba(241, 70, 104, 0.25); }\n .checkbox:hover,\n .radio:hover {\n color: #dbdbdb; }\n .checkbox[disabled], fieldset[disabled] .checkbox,\n .radio[disabled], fieldset[disabled] .radio {\n color: #b5b5b5; }\n .select:not(.is-multiple):not(.is-loading)::after {\n border-color: #e60056; }\n .select select {\n background-color: #0a0a0a;\n border-color: #363636;\n color: #dbdbdb; }\n .select select::-moz-placeholder {\n color: rgba(219, 219, 219, 0.3); }\n .select select::-webkit-input-placeholder {\n color: rgba(219, 219, 219, 0.3); }\n .select select:-moz-placeholder {\n color: rgba(219, 219, 219, 0.3); }\n .select select:-ms-input-placeholder {\n color: rgba(219, 219, 219, 0.3); }\n .select select:hover, .select select.is-hovered {\n border-color: #4a4a4a; }\n .select select:focus, .select select.is-focused, .select select:active, .select select.is-active {\n border-color: #e60056;\n box-shadow: 0 0 0 0.125em rgba(230, 0, 86, 0.25); }\n .select select[disabled], fieldset[disabled] .select select {\n background-color: #242424;\n border-color: #242424;\n color: #b5b5b5; }\n .select select[disabled]::-moz-placeholder, fieldset[disabled] .select select::-moz-placeholder {\n color: rgba(181, 181, 181, 0.3); }\n .select select[disabled]::-webkit-input-placeholder, fieldset[disabled] .select select::-webkit-input-placeholder {\n color: rgba(181, 181, 181, 0.3); }\n .select select[disabled]:-moz-placeholder, fieldset[disabled] .select select:-moz-placeholder {\n color: rgba(181, 181, 181, 0.3); }\n .select select[disabled]:-ms-input-placeholder, fieldset[disabled] .select select:-ms-input-placeholder {\n color: rgba(181, 181, 181, 0.3); }\n .select select[disabled]:hover, fieldset[disabled] .select select:hover {\n border-color: #242424; }\n .select select option {\n color: #dbdbdb; }\n .select:not(.is-multiple):not(.is-loading):hover::after {\n border-color: #dbdbdb; }\n .select.is-white:not(:hover)::after {\n border-color: #e6e6e6; }\n .select.is-white select {\n border-color: #e6e6e6; }\n .select.is-white select:hover, .select.is-white select.is-hovered {\n border-color: #d9d9d9; }\n .select.is-white select:focus, .select.is-white select.is-focused, .select.is-white select:active, .select.is-white select.is-active {\n box-shadow: 0 0 0 0.125em rgba(230, 230, 230, 0.25); }\n .select.is-black:not(:hover)::after {\n border-color: black; }\n .select.is-black select {\n border-color: black; }\n .select.is-black select:hover, .select.is-black select.is-hovered {\n border-color: black; }\n .select.is-black select:focus, .select.is-black select.is-focused, .select.is-black select:active, .select.is-black select.is-active {\n box-shadow: 0 0 0 0.125em rgba(0, 0, 0, 0.25); }\n .select.is-light:not(:hover)::after {\n border-color: #dbdbdb; }\n .select.is-light select {\n border-color: #dbdbdb; }\n .select.is-light select:hover, .select.is-light select.is-hovered {\n border-color: #cfcfcf; }\n .select.is-light select:focus, .select.is-light select.is-focused, .select.is-light select:active, .select.is-light select.is-active {\n box-shadow: 0 0 0 0.125em rgba(219, 219, 219, 0.25); }\n .select.is-dark:not(:hover)::after {\n border-color: #1c1c1c; }\n .select.is-dark select {\n border-color: #1c1c1c; }\n .select.is-dark select:hover, .select.is-dark select.is-hovered {\n border-color: #0f0f0f; }\n .select.is-dark select:focus, .select.is-dark select.is-focused, .select.is-dark select:active, .select.is-dark select.is-active {\n box-shadow: 0 0 0 0.125em rgba(28, 28, 28, 0.25); }\n .select.is-primary:not(:hover)::after {\n border-color: #d90052; }\n .select.is-primary select {\n border-color: #d90052; }\n .select.is-primary select:hover, .select.is-primary select.is-hovered {\n border-color: #c00048; }\n .select.is-primary select:focus, .select.is-primary select.is-focused, .select.is-primary select:active, .select.is-primary select.is-active {\n box-shadow: 0 0 0 0.125em rgba(217, 0, 82, 0.25); }\n .select.is-link:not(:hover)::after {\n border-color: #d90052; }\n .select.is-link select {\n border-color: #d90052; }\n .select.is-link select:hover, .select.is-link select.is-hovered {\n border-color: #c00048; }\n .select.is-link select:focus, .select.is-link select.is-focused, .select.is-link select:active, .select.is-link select.is-active {\n box-shadow: 0 0 0 0.125em rgba(217, 0, 82, 0.25); }\n .select.is-info:not(:hover)::after {\n border-color: #0075cc; }\n .select.is-info select {\n border-color: #0075cc; }\n .select.is-info select:hover, .select.is-info select.is-hovered {\n border-color: #0066b3; }\n .select.is-info select:focus, .select.is-info select.is-focused, .select.is-info select:active, .select.is-info select.is-active {\n box-shadow: 0 0 0 0.125em rgba(0, 117, 204, 0.25); }\n .select.is-success:not(:hover)::after {\n border-color: #11ad74; }\n .select.is-success select {\n border-color: #11ad74; }\n .select.is-success select:hover, .select.is-success select.is-hovered {\n border-color: #0f9564; }\n .select.is-success select:focus, .select.is-success select.is-focused, .select.is-success select:active, .select.is-success select.is-active {\n box-shadow: 0 0 0 0.125em rgba(17, 173, 116, 0.25); }\n .select.is-warning:not(:hover)::after {\n border-color: #ccba00; }\n .select.is-warning select {\n border-color: #ccba00; }\n .select.is-warning select:hover, .select.is-warning select.is-hovered {\n border-color: #b3a300; }\n .select.is-warning select:focus, .select.is-warning select.is-focused, .select.is-warning select:active, .select.is-warning select.is-active {\n box-shadow: 0 0 0 0.125em rgba(204, 186, 0, 0.25); }\n .select.is-danger:not(:hover)::after {\n border-color: #ee1742; }\n .select.is-danger select {\n border-color: #ee1742; }\n .select.is-danger select:hover, .select.is-danger select.is-hovered {\n border-color: #da1039; }\n .select.is-danger select:focus, .select.is-danger select.is-focused, .select.is-danger select:active, .select.is-danger select.is-active {\n box-shadow: 0 0 0 0.125em rgba(238, 23, 66, 0.25); }\n .select.is-white-dark:not(:hover)::after {\n border-color: white; }\n .select.is-white-dark select {\n border-color: white; }\n .select.is-white-dark select:hover, .select.is-white-dark select.is-hovered {\n border-color: #f2f2f2; }\n .select.is-white-dark select:focus, .select.is-white-dark select.is-focused, .select.is-white-dark select:active, .select.is-white-dark select.is-active {\n box-shadow: 0 0 0 0.125em rgba(255, 255, 255, 0.25); }\n .select.is-black-dark:not(:hover)::after {\n border-color: #0a0a0a; }\n .select.is-black-dark select {\n border-color: #0a0a0a; }\n .select.is-black-dark select:hover, .select.is-black-dark select.is-hovered {\n border-color: black; }\n .select.is-black-dark select:focus, .select.is-black-dark select.is-focused, .select.is-black-dark select:active, .select.is-black-dark select.is-active {\n box-shadow: 0 0 0 0.125em rgba(10, 10, 10, 0.25); }\n .select.is-light-dark:not(:hover)::after {\n border-color: whitesmoke; }\n .select.is-light-dark select {\n border-color: whitesmoke; }\n .select.is-light-dark select:hover, .select.is-light-dark select.is-hovered {\n border-color: #e8e8e8; }\n .select.is-light-dark select:focus, .select.is-light-dark select.is-focused, .select.is-light-dark select:active, .select.is-light-dark select.is-active {\n box-shadow: 0 0 0 0.125em rgba(245, 245, 245, 0.25); }\n .select.is-dark-dark:not(:hover)::after {\n border-color: #363636; }\n .select.is-dark-dark select {\n border-color: #363636; }\n .select.is-dark-dark select:hover, .select.is-dark-dark select.is-hovered {\n border-color: #292929; }\n .select.is-dark-dark select:focus, .select.is-dark-dark select.is-focused, .select.is-dark-dark select:active, .select.is-dark-dark select.is-active {\n box-shadow: 0 0 0 0.125em rgba(54, 54, 54, 0.25); }\n .select.is-primary-dark:not(:hover)::after {\n border-color: #ff0d68; }\n .select.is-primary-dark select {\n border-color: #ff0d68; }\n .select.is-primary-dark select:hover, .select.is-primary-dark select.is-hovered {\n border-color: #f3005b; }\n .select.is-primary-dark select:focus, .select.is-primary-dark select.is-focused, .select.is-primary-dark select:active, .select.is-primary-dark select.is-active {\n box-shadow: 0 0 0 0.125em rgba(255, 13, 104, 0.25); }\n .select.is-link-dark:not(:hover)::after {\n border-color: #ff0d68; }\n .select.is-link-dark select {\n border-color: #ff0d68; }\n .select.is-link-dark select:hover, .select.is-link-dark select.is-hovered {\n border-color: #f3005b; }\n .select.is-link-dark select:focus, .select.is-link-dark select.is-focused, .select.is-link-dark select:active, .select.is-link-dark select.is-active {\n box-shadow: 0 0 0 0.125em rgba(255, 13, 104, 0.25); }\n .select.is-info-dark:not(:hover)::after {\n border-color: #0092FF; }\n .select.is-info-dark select {\n border-color: #0092FF; }\n .select.is-info-dark select:hover, .select.is-info-dark select.is-hovered {\n border-color: #0083e6; }\n .select.is-info-dark select:focus, .select.is-info-dark select.is-focused, .select.is-info-dark select:active, .select.is-info-dark select.is-active {\n box-shadow: 0 0 0 0.125em rgba(0, 146, 255, 0.25); }\n .select.is-success-dark:not(:hover)::after {\n border-color: #16DB93; }\n .select.is-success-dark select {\n border-color: #16DB93; }\n .select.is-success-dark select:hover, .select.is-success-dark select.is-hovered {\n border-color: #14c483; }\n .select.is-success-dark select:focus, .select.is-success-dark select.is-focused, .select.is-success-dark select:active, .select.is-success-dark select.is-active {\n box-shadow: 0 0 0 0.125em rgba(22, 219, 147, 0.25); }\n .select.is-warning-dark:not(:hover)::after {\n border-color: #FFE900; }\n .select.is-warning-dark select {\n border-color: #FFE900; }\n .select.is-warning-dark select:hover, .select.is-warning-dark select.is-hovered {\n border-color: #e6d200; }\n .select.is-warning-dark select:focus, .select.is-warning-dark select.is-focused, .select.is-warning-dark select:active, .select.is-warning-dark select.is-active {\n box-shadow: 0 0 0 0.125em rgba(255, 233, 0, 0.25); }\n .select.is-danger-dark:not(:hover)::after {\n border-color: #f14668; }\n .select.is-danger-dark select {\n border-color: #f14668; }\n .select.is-danger-dark select:hover, .select.is-danger-dark select.is-hovered {\n border-color: #ef2e55; }\n .select.is-danger-dark select:focus, .select.is-danger-dark select.is-focused, .select.is-danger-dark select:active, .select.is-danger-dark select.is-active {\n box-shadow: 0 0 0 0.125em rgba(241, 70, 104, 0.25); }\n .select.is-disabled::after {\n border-color: #b5b5b5; }\n .file.is-white .file-cta {\n background-color: #e6e6e6;\n color: #0a0a0a; }\n .file.is-white:hover .file-cta, .file.is-white.is-hovered .file-cta {\n background-color: #dfdfdf;\n color: #0a0a0a; }\n .file.is-white:focus .file-cta, .file.is-white.is-focused .file-cta {\n box-shadow: 0 0 0.5em rgba(230, 230, 230, 0.25);\n color: #0a0a0a; }\n .file.is-white:active .file-cta, .file.is-white.is-active .file-cta {\n background-color: #d9d9d9;\n color: #0a0a0a; }\n .file.is-black .file-cta {\n background-color: black;\n color: white; }\n .file.is-black:hover .file-cta, .file.is-black.is-hovered .file-cta {\n background-color: black;\n color: white; }\n .file.is-black:focus .file-cta, .file.is-black.is-focused .file-cta {\n box-shadow: 0 0 0.5em rgba(0, 0, 0, 0.25);\n color: white; }\n .file.is-black:active .file-cta, .file.is-black.is-active .file-cta {\n background-color: black;\n color: white; }\n .file.is-light .file-cta {\n background-color: #dbdbdb;\n color: rgba(0, 0, 0, 0.7); }\n .file.is-light:hover .file-cta, .file.is-light.is-hovered .file-cta {\n background-color: #d5d5d5;\n color: rgba(0, 0, 0, 0.7); }\n .file.is-light:focus .file-cta, .file.is-light.is-focused .file-cta {\n box-shadow: 0 0 0.5em rgba(219, 219, 219, 0.25);\n color: rgba(0, 0, 0, 0.7); }\n .file.is-light:active .file-cta, .file.is-light.is-active .file-cta {\n background-color: #cfcfcf;\n color: rgba(0, 0, 0, 0.7); }\n .file.is-dark .file-cta {\n background-color: #1c1c1c;\n color: #fff; }\n .file.is-dark:hover .file-cta, .file.is-dark.is-hovered .file-cta {\n background-color: #161616;\n color: #fff; }\n .file.is-dark:focus .file-cta, .file.is-dark.is-focused .file-cta {\n box-shadow: 0 0 0.5em rgba(28, 28, 28, 0.25);\n color: #fff; }\n .file.is-dark:active .file-cta, .file.is-dark.is-active .file-cta {\n background-color: #0f0f0f;\n color: #fff; }\n .file.is-primary .file-cta {\n background-color: #d90052;\n color: #fff; }\n .file.is-primary:hover .file-cta, .file.is-primary.is-hovered .file-cta {\n background-color: #cc004d;\n color: #fff; }\n .file.is-primary:focus .file-cta, .file.is-primary.is-focused .file-cta {\n box-shadow: 0 0 0.5em rgba(217, 0, 82, 0.25);\n color: #fff; }\n .file.is-primary:active .file-cta, .file.is-primary.is-active .file-cta {\n background-color: #c00048;\n color: #fff; }\n .file.is-link .file-cta {\n background-color: #d90052;\n color: #fff; }\n .file.is-link:hover .file-cta, .file.is-link.is-hovered .file-cta {\n background-color: #cc004d;\n color: #fff; }\n .file.is-link:focus .file-cta, .file.is-link.is-focused .file-cta {\n box-shadow: 0 0 0.5em rgba(217, 0, 82, 0.25);\n color: #fff; }\n .file.is-link:active .file-cta, .file.is-link.is-active .file-cta {\n background-color: #c00048;\n color: #fff; }\n .file.is-info .file-cta {\n background-color: #0075cc;\n color: #fff; }\n .file.is-info:hover .file-cta, .file.is-info.is-hovered .file-cta {\n background-color: #006ebf;\n color: #fff; }\n .file.is-info:focus .file-cta, .file.is-info.is-focused .file-cta {\n box-shadow: 0 0 0.5em rgba(0, 117, 204, 0.25);\n color: #fff; }\n .file.is-info:active .file-cta, .file.is-info.is-active .file-cta {\n background-color: #0066b3;\n color: #fff; }\n .file.is-success .file-cta {\n background-color: #11ad74;\n color: rgba(0, 0, 0, 0.7); }\n .file.is-success:hover .file-cta, .file.is-success.is-hovered .file-cta {\n background-color: #10a16c;\n color: rgba(0, 0, 0, 0.7); }\n .file.is-success:focus .file-cta, .file.is-success.is-focused .file-cta {\n box-shadow: 0 0 0.5em rgba(17, 173, 116, 0.25);\n color: rgba(0, 0, 0, 0.7); }\n .file.is-success:active .file-cta, .file.is-success.is-active .file-cta {\n background-color: #0f9564;\n color: rgba(0, 0, 0, 0.7); }\n .file.is-warning .file-cta {\n background-color: #ccba00;\n color: rgba(0, 0, 0, 0.7); }\n .file.is-warning:hover .file-cta, .file.is-warning.is-hovered .file-cta {\n background-color: #bfaf00;\n color: rgba(0, 0, 0, 0.7); }\n .file.is-warning:focus .file-cta, .file.is-warning.is-focused .file-cta {\n box-shadow: 0 0 0.5em rgba(204, 186, 0, 0.25);\n color: rgba(0, 0, 0, 0.7); }\n .file.is-warning:active .file-cta, .file.is-warning.is-active .file-cta {\n background-color: #b3a300;\n color: rgba(0, 0, 0, 0.7); }\n .file.is-danger .file-cta {\n background-color: #ee1742;\n color: #fff; }\n .file.is-danger:hover .file-cta, .file.is-danger.is-hovered .file-cta {\n background-color: #e6113c;\n color: #fff; }\n .file.is-danger:focus .file-cta, .file.is-danger.is-focused .file-cta {\n box-shadow: 0 0 0.5em rgba(238, 23, 66, 0.25);\n color: #fff; }\n .file.is-danger:active .file-cta, .file.is-danger.is-active .file-cta {\n background-color: #da1039;\n color: #fff; }\n .file.is-white-dark .file-cta {\n background-color: white;\n color: #0a0a0a; }\n .file.is-white-dark:hover .file-cta, .file.is-white-dark.is-hovered .file-cta {\n background-color: #f9f9f9;\n color: #0a0a0a; }\n .file.is-white-dark:focus .file-cta, .file.is-white-dark.is-focused .file-cta {\n box-shadow: 0 0 0.5em rgba(255, 255, 255, 0.25);\n color: #0a0a0a; }\n .file.is-white-dark:active .file-cta, .file.is-white-dark.is-active .file-cta {\n background-color: #f2f2f2;\n color: #0a0a0a; }\n .file.is-black-dark .file-cta {\n background-color: #0a0a0a;\n color: white; }\n .file.is-black-dark:hover .file-cta, .file.is-black-dark.is-hovered .file-cta {\n background-color: #040404;\n color: white; }\n .file.is-black-dark:focus .file-cta, .file.is-black-dark.is-focused .file-cta {\n box-shadow: 0 0 0.5em rgba(10, 10, 10, 0.25);\n color: white; }\n .file.is-black-dark:active .file-cta, .file.is-black-dark.is-active .file-cta {\n background-color: black;\n color: white; }\n .file.is-light-dark .file-cta {\n background-color: whitesmoke;\n color: rgba(0, 0, 0, 0.7); }\n .file.is-light-dark:hover .file-cta, .file.is-light-dark.is-hovered .file-cta {\n background-color: #eeeeee;\n color: rgba(0, 0, 0, 0.7); }\n .file.is-light-dark:focus .file-cta, .file.is-light-dark.is-focused .file-cta {\n box-shadow: 0 0 0.5em rgba(245, 245, 245, 0.25);\n color: rgba(0, 0, 0, 0.7); }\n .file.is-light-dark:active .file-cta, .file.is-light-dark.is-active .file-cta {\n background-color: #e8e8e8;\n color: rgba(0, 0, 0, 0.7); }\n .file.is-dark-dark .file-cta {\n background-color: #363636;\n color: #fff; }\n .file.is-dark-dark:hover .file-cta, .file.is-dark-dark.is-hovered .file-cta {\n background-color: #2f2f2f;\n color: #fff; }\n .file.is-dark-dark:focus .file-cta, .file.is-dark-dark.is-focused .file-cta {\n box-shadow: 0 0 0.5em rgba(54, 54, 54, 0.25);\n color: #fff; }\n .file.is-dark-dark:active .file-cta, .file.is-dark-dark.is-active .file-cta {\n background-color: #292929;\n color: #fff; }\n .file.is-primary-dark .file-cta {\n background-color: #ff0d68;\n color: #fff; }\n .file.is-primary-dark:hover .file-cta, .file.is-primary-dark.is-hovered .file-cta {\n background-color: #ff0060;\n color: #fff; }\n .file.is-primary-dark:focus .file-cta, .file.is-primary-dark.is-focused .file-cta {\n box-shadow: 0 0 0.5em rgba(255, 13, 104, 0.25);\n color: #fff; }\n .file.is-primary-dark:active .file-cta, .file.is-primary-dark.is-active .file-cta {\n background-color: #f3005b;\n color: #fff; }\n .file.is-link-dark .file-cta {\n background-color: #ff0d68;\n color: #fff; }\n .file.is-link-dark:hover .file-cta, .file.is-link-dark.is-hovered .file-cta {\n background-color: #ff0060;\n color: #fff; }\n .file.is-link-dark:focus .file-cta, .file.is-link-dark.is-focused .file-cta {\n box-shadow: 0 0 0.5em rgba(255, 13, 104, 0.25);\n color: #fff; }\n .file.is-link-dark:active .file-cta, .file.is-link-dark.is-active .file-cta {\n background-color: #f3005b;\n color: #fff; }\n .file.is-info-dark .file-cta {\n background-color: #0092FF;\n color: #fff; }\n .file.is-info-dark:hover .file-cta, .file.is-info-dark.is-hovered .file-cta {\n background-color: #008bf2;\n color: #fff; }\n .file.is-info-dark:focus .file-cta, .file.is-info-dark.is-focused .file-cta {\n box-shadow: 0 0 0.5em rgba(0, 146, 255, 0.25);\n color: #fff; }\n .file.is-info-dark:active .file-cta, .file.is-info-dark.is-active .file-cta {\n background-color: #0083e6;\n color: #fff; }\n .file.is-success-dark .file-cta {\n background-color: #16DB93;\n color: rgba(0, 0, 0, 0.7); }\n .file.is-success-dark:hover .file-cta, .file.is-success-dark.is-hovered .file-cta {\n background-color: #15cf8b;\n color: rgba(0, 0, 0, 0.7); }\n .file.is-success-dark:focus .file-cta, .file.is-success-dark.is-focused .file-cta {\n box-shadow: 0 0 0.5em rgba(22, 219, 147, 0.25);\n color: rgba(0, 0, 0, 0.7); }\n .file.is-success-dark:active .file-cta, .file.is-success-dark.is-active .file-cta {\n background-color: #14c483;\n color: rgba(0, 0, 0, 0.7); }\n .file.is-warning-dark .file-cta {\n background-color: #FFE900;\n color: rgba(0, 0, 0, 0.7); }\n .file.is-warning-dark:hover .file-cta, .file.is-warning-dark.is-hovered .file-cta {\n background-color: #f2dd00;\n color: rgba(0, 0, 0, 0.7); }\n .file.is-warning-dark:focus .file-cta, .file.is-warning-dark.is-focused .file-cta {\n box-shadow: 0 0 0.5em rgba(255, 233, 0, 0.25);\n color: rgba(0, 0, 0, 0.7); }\n .file.is-warning-dark:active .file-cta, .file.is-warning-dark.is-active .file-cta {\n background-color: #e6d200;\n color: rgba(0, 0, 0, 0.7); }\n .file.is-danger-dark .file-cta {\n background-color: #f14668;\n color: #fff; }\n .file.is-danger-dark:hover .file-cta, .file.is-danger-dark.is-hovered .file-cta {\n background-color: #f03a5f;\n color: #fff; }\n .file.is-danger-dark:focus .file-cta, .file.is-danger-dark.is-focused .file-cta {\n box-shadow: 0 0 0.5em rgba(241, 70, 104, 0.25);\n color: #fff; }\n .file.is-danger-dark:active .file-cta, .file.is-danger-dark.is-active .file-cta {\n background-color: #ef2e55;\n color: #fff; }\n .file-label:hover .file-cta {\n background-color: #1d1d1d;\n color: #dbdbdb; }\n .file-label:hover .file-name {\n border-color: #2f2f2f; }\n .file-label:active .file-cta {\n background-color: #171717;\n color: #dbdbdb; }\n .file-label:active .file-name {\n border-color: #292929; }\n .file-cta,\n .file-name {\n border-color: #363636; }\n .file-cta {\n background-color: #242424;\n color: #b5b5b5; }\n .file-name {\n border-color: #363636; }\n .label {\n color: #dbdbdb; }\n .help.is-white {\n color: #e6e6e6; }\n .help.is-black {\n color: black; }\n .help.is-light {\n color: #dbdbdb; }\n .help.is-dark {\n color: #1c1c1c; }\n .help.is-primary {\n color: #d90052; }\n .help.is-link {\n color: #d90052; }\n .help.is-info {\n color: #0075cc; }\n .help.is-success {\n color: #11ad74; }\n .help.is-warning {\n color: #ccba00; }\n .help.is-danger {\n color: #ee1742; }\n .help.is-white-dark {\n color: white; }\n .help.is-black-dark {\n color: #0a0a0a; }\n .help.is-light-dark {\n color: whitesmoke; }\n .help.is-dark-dark {\n color: #363636; }\n .help.is-primary-dark {\n color: #ff0d68; }\n .help.is-link-dark {\n color: #ff0d68; }\n .help.is-info-dark {\n color: #0092FF; }\n .help.is-success-dark {\n color: #16DB93; }\n .help.is-warning-dark {\n color: #FFE900; }\n .help.is-danger-dark {\n color: #f14668; }\n .control.has-icons-left .icon, .control.has-icons-right .icon {\n color: #363636; }\n .notification {\n background-color: #242424; }\n .notification code,\n .notification pre {\n background: #0a0a0a; }\n .notification.is-white {\n background-color: #e6e6e6;\n color: #0a0a0a; }\n .notification.is-black {\n background-color: black;\n color: white; }\n .notification.is-light {\n background-color: #dbdbdb;\n color: rgba(0, 0, 0, 0.7); }\n .notification.is-dark {\n background-color: #1c1c1c;\n color: #fff; }\n .notification.is-primary {\n background-color: #d90052;\n color: #fff; }\n .notification.is-link {\n background-color: #d90052;\n color: #fff; }\n .notification.is-info {\n background-color: #0075cc;\n color: #fff; }\n .notification.is-success {\n background-color: #11ad74;\n color: rgba(0, 0, 0, 0.7); }\n .notification.is-warning {\n background-color: #ccba00;\n color: rgba(0, 0, 0, 0.7); }\n .notification.is-danger {\n background-color: #ee1742;\n color: #fff; }\n .notification.is-white-dark {\n background-color: white;\n color: #0a0a0a; }\n .notification.is-black-dark {\n background-color: #0a0a0a;\n color: white; }\n .notification.is-light-dark {\n background-color: whitesmoke;\n color: rgba(0, 0, 0, 0.7); }\n .notification.is-dark-dark {\n background-color: #363636;\n color: #fff; }\n .notification.is-primary-dark {\n background-color: #ff0d68;\n color: #fff; }\n .notification.is-link-dark {\n background-color: #ff0d68;\n color: #fff; }\n .notification.is-info-dark {\n background-color: #0092FF;\n color: #fff; }\n .notification.is-success-dark {\n background-color: #16DB93;\n color: rgba(0, 0, 0, 0.7); }\n .notification.is-warning-dark {\n background-color: #FFE900;\n color: rgba(0, 0, 0, 0.7); }\n .notification.is-danger-dark {\n background-color: #f14668;\n color: #fff; }\n .progress::-webkit-progress-bar {\n background-color: #363636; }\n .progress::-webkit-progress-value {\n background-color: #b5b5b5; }\n .progress::-moz-progress-bar {\n background-color: #b5b5b5; }\n .progress::-ms-fill {\n background-color: #b5b5b5; }\n .progress:indeterminate {\n background-color: #363636;\n background-image: linear-gradient(to right, #4a4a4a 30%, #363636 30%); }\n .progress.is-white::-webkit-progress-value {\n background-color: #e6e6e6; }\n .progress.is-white::-moz-progress-bar {\n background-color: #e6e6e6; }\n .progress.is-white::-ms-fill {\n background-color: #e6e6e6; }\n .progress.is-white:indeterminate {\n background-image: linear-gradient(to right, #e6e6e6 30%, #363636 30%); }\n .progress.is-black::-webkit-progress-value {\n background-color: black; }\n .progress.is-black::-moz-progress-bar {\n background-color: black; }\n .progress.is-black::-ms-fill {\n background-color: black; }\n .progress.is-black:indeterminate {\n background-image: linear-gradient(to right, black 30%, #363636 30%); }\n .progress.is-light::-webkit-progress-value {\n background-color: #dbdbdb; }\n .progress.is-light::-moz-progress-bar {\n background-color: #dbdbdb; }\n .progress.is-light::-ms-fill {\n background-color: #dbdbdb; }\n .progress.is-light:indeterminate {\n background-image: linear-gradient(to right, #dbdbdb 30%, #363636 30%); }\n .progress.is-dark::-webkit-progress-value {\n background-color: #1c1c1c; }\n .progress.is-dark::-moz-progress-bar {\n background-color: #1c1c1c; }\n .progress.is-dark::-ms-fill {\n background-color: #1c1c1c; }\n .progress.is-dark:indeterminate {\n background-image: linear-gradient(to right, #1c1c1c 30%, #363636 30%); }\n .progress.is-primary::-webkit-progress-value {\n background-color: #d90052; }\n .progress.is-primary::-moz-progress-bar {\n background-color: #d90052; }\n .progress.is-primary::-ms-fill {\n background-color: #d90052; }\n .progress.is-primary:indeterminate {\n background-image: linear-gradient(to right, #d90052 30%, #363636 30%); }\n .progress.is-link::-webkit-progress-value {\n background-color: #d90052; }\n .progress.is-link::-moz-progress-bar {\n background-color: #d90052; }\n .progress.is-link::-ms-fill {\n background-color: #d90052; }\n .progress.is-link:indeterminate {\n background-image: linear-gradient(to right, #d90052 30%, #363636 30%); }\n .progress.is-info::-webkit-progress-value {\n background-color: #0075cc; }\n .progress.is-info::-moz-progress-bar {\n background-color: #0075cc; }\n .progress.is-info::-ms-fill {\n background-color: #0075cc; }\n .progress.is-info:indeterminate {\n background-image: linear-gradient(to right, #0075cc 30%, #363636 30%); }\n .progress.is-success::-webkit-progress-value {\n background-color: #11ad74; }\n .progress.is-success::-moz-progress-bar {\n background-color: #11ad74; }\n .progress.is-success::-ms-fill {\n background-color: #11ad74; }\n .progress.is-success:indeterminate {\n background-image: linear-gradient(to right, #11ad74 30%, #363636 30%); }\n .progress.is-warning::-webkit-progress-value {\n background-color: #ccba00; }\n .progress.is-warning::-moz-progress-bar {\n background-color: #ccba00; }\n .progress.is-warning::-ms-fill {\n background-color: #ccba00; }\n .progress.is-warning:indeterminate {\n background-image: linear-gradient(to right, #ccba00 30%, #363636 30%); }\n .progress.is-danger::-webkit-progress-value {\n background-color: #ee1742; }\n .progress.is-danger::-moz-progress-bar {\n background-color: #ee1742; }\n .progress.is-danger::-ms-fill {\n background-color: #ee1742; }\n .progress.is-danger:indeterminate {\n background-image: linear-gradient(to right, #ee1742 30%, #363636 30%); }\n .progress.is-white-dark::-webkit-progress-value {\n background-color: white; }\n .progress.is-white-dark::-moz-progress-bar {\n background-color: white; }\n .progress.is-white-dark::-ms-fill {\n background-color: white; }\n .progress.is-white-dark:indeterminate {\n background-image: linear-gradient(to right, white 30%, #363636 30%); }\n .progress.is-black-dark::-webkit-progress-value {\n background-color: #0a0a0a; }\n .progress.is-black-dark::-moz-progress-bar {\n background-color: #0a0a0a; }\n .progress.is-black-dark::-ms-fill {\n background-color: #0a0a0a; }\n .progress.is-black-dark:indeterminate {\n background-image: linear-gradient(to right, #0a0a0a 30%, #363636 30%); }\n .progress.is-light-dark::-webkit-progress-value {\n background-color: whitesmoke; }\n .progress.is-light-dark::-moz-progress-bar {\n background-color: whitesmoke; }\n .progress.is-light-dark::-ms-fill {\n background-color: whitesmoke; }\n .progress.is-light-dark:indeterminate {\n background-image: linear-gradient(to right, whitesmoke 30%, #363636 30%); }\n .progress.is-dark-dark::-webkit-progress-value {\n background-color: #363636; }\n .progress.is-dark-dark::-moz-progress-bar {\n background-color: #363636; }\n .progress.is-dark-dark::-ms-fill {\n background-color: #363636; }\n .progress.is-dark-dark:indeterminate {\n background-image: linear-gradient(to right, #363636 30%, #363636 30%); }\n .progress.is-primary-dark::-webkit-progress-value {\n background-color: #ff0d68; }\n .progress.is-primary-dark::-moz-progress-bar {\n background-color: #ff0d68; }\n .progress.is-primary-dark::-ms-fill {\n background-color: #ff0d68; }\n .progress.is-primary-dark:indeterminate {\n background-image: linear-gradient(to right, #ff0d68 30%, #363636 30%); }\n .progress.is-link-dark::-webkit-progress-value {\n background-color: #ff0d68; }\n .progress.is-link-dark::-moz-progress-bar {\n background-color: #ff0d68; }\n .progress.is-link-dark::-ms-fill {\n background-color: #ff0d68; }\n .progress.is-link-dark:indeterminate {\n background-image: linear-gradient(to right, #ff0d68 30%, #363636 30%); }\n .progress.is-info-dark::-webkit-progress-value {\n background-color: #0092FF; }\n .progress.is-info-dark::-moz-progress-bar {\n background-color: #0092FF; }\n .progress.is-info-dark::-ms-fill {\n background-color: #0092FF; }\n .progress.is-info-dark:indeterminate {\n background-image: linear-gradient(to right, #0092FF 30%, #363636 30%); }\n .progress.is-success-dark::-webkit-progress-value {\n background-color: #16DB93; }\n .progress.is-success-dark::-moz-progress-bar {\n background-color: #16DB93; }\n .progress.is-success-dark::-ms-fill {\n background-color: #16DB93; }\n .progress.is-success-dark:indeterminate {\n background-image: linear-gradient(to right, #16DB93 30%, #363636 30%); }\n .progress.is-warning-dark::-webkit-progress-value {\n background-color: #FFE900; }\n .progress.is-warning-dark::-moz-progress-bar {\n background-color: #FFE900; }\n .progress.is-warning-dark::-ms-fill {\n background-color: #FFE900; }\n .progress.is-warning-dark:indeterminate {\n background-image: linear-gradient(to right, #FFE900 30%, #363636 30%); }\n .progress.is-danger-dark::-webkit-progress-value {\n background-color: #f14668; }\n .progress.is-danger-dark::-moz-progress-bar {\n background-color: #f14668; }\n .progress.is-danger-dark::-ms-fill {\n background-color: #f14668; }\n .progress.is-danger-dark:indeterminate {\n background-image: linear-gradient(to right, #f14668 30%, #363636 30%); }\n .table {\n background-color: #0a0a0a;\n color: #dbdbdb; }\n .table td,\n .table th {\n border: 1px solid #363636; }\n .table td.is-white,\n .table th.is-white {\n background-color: #e6e6e6;\n border-color: #e6e6e6;\n color: #0a0a0a; }\n .table td.is-black,\n .table th.is-black {\n background-color: black;\n border-color: black;\n color: white; }\n .table td.is-light,\n .table th.is-light {\n background-color: #dbdbdb;\n border-color: #dbdbdb;\n color: rgba(0, 0, 0, 0.7); }\n .table td.is-dark,\n .table th.is-dark {\n background-color: #1c1c1c;\n border-color: #1c1c1c;\n color: #fff; }\n .table td.is-primary,\n .table th.is-primary {\n background-color: #d90052;\n border-color: #d90052;\n color: #fff; }\n .table td.is-link,\n .table th.is-link {\n background-color: #d90052;\n border-color: #d90052;\n color: #fff; }\n .table td.is-info,\n .table th.is-info {\n background-color: #0075cc;\n border-color: #0075cc;\n color: #fff; }\n .table td.is-success,\n .table th.is-success {\n background-color: #11ad74;\n border-color: #11ad74;\n color: rgba(0, 0, 0, 0.7); }\n .table td.is-warning,\n .table th.is-warning {\n background-color: #ccba00;\n border-color: #ccba00;\n color: rgba(0, 0, 0, 0.7); }\n .table td.is-danger,\n .table th.is-danger {\n background-color: #ee1742;\n border-color: #ee1742;\n color: #fff; }\n .table td.is-white-dark,\n .table th.is-white-dark {\n background-color: white;\n border-color: white;\n color: #0a0a0a; }\n .table td.is-black-dark,\n .table th.is-black-dark {\n background-color: #0a0a0a;\n border-color: #0a0a0a;\n color: white; }\n .table td.is-light-dark,\n .table th.is-light-dark {\n background-color: whitesmoke;\n border-color: whitesmoke;\n color: rgba(0, 0, 0, 0.7); }\n .table td.is-dark-dark,\n .table th.is-dark-dark {\n background-color: #363636;\n border-color: #363636;\n color: #fff; }\n .table td.is-primary-dark,\n .table th.is-primary-dark {\n background-color: #ff0d68;\n border-color: #ff0d68;\n color: #fff; }\n .table td.is-link-dark,\n .table th.is-link-dark {\n background-color: #ff0d68;\n border-color: #ff0d68;\n color: #fff; }\n .table td.is-info-dark,\n .table th.is-info-dark {\n background-color: #0092FF;\n border-color: #0092FF;\n color: #fff; }\n .table td.is-success-dark,\n .table th.is-success-dark {\n background-color: #16DB93;\n border-color: #16DB93;\n color: rgba(0, 0, 0, 0.7); }\n .table td.is-warning-dark,\n .table th.is-warning-dark {\n background-color: #FFE900;\n border-color: #FFE900;\n color: rgba(0, 0, 0, 0.7); }\n .table td.is-danger-dark,\n .table th.is-danger-dark {\n background-color: #f14668;\n border-color: #f14668;\n color: #fff; }\n .table td.is-selected,\n .table th.is-selected {\n background-color: #e60056;\n color: #e6e6e6; }\n .table th {\n color: #dbdbdb; }\n .table tr.is-selected {\n background-color: #e60056;\n color: #e6e6e6; }\n .table tr.is-selected td,\n .table tr.is-selected th {\n border-color: #e6e6e6; }\n .table thead td,\n .table thead th {\n color: #dbdbdb; }\n .table tfoot td,\n .table tfoot th {\n color: #dbdbdb; }\n .table.is-hoverable tbody tr:not(.is-selected):hover {\n background-color: #121212; }\n .table.is-hoverable.is-striped tbody tr:not(.is-selected):hover {\n background-color: #121212; }\n .table.is-hoverable.is-striped tbody tr:not(.is-selected):hover:nth-child(even) {\n background-color: #242424; }\n .table.is-striped tbody tr:not(.is-selected):nth-child(even) {\n background-color: #121212; }\n .tag:not(body) {\n background-color: #242424;\n color: #b5b5b5; }\n .tag:not(body).is-white {\n background-color: #e6e6e6;\n color: #0a0a0a; }\n .tag:not(body).is-black {\n background-color: black;\n color: white; }\n .tag:not(body).is-light {\n background-color: #dbdbdb;\n color: rgba(0, 0, 0, 0.7); }\n .tag:not(body).is-dark {\n background-color: #1c1c1c;\n color: #fff; }\n .tag:not(body).is-primary {\n background-color: #d90052;\n color: #fff; }\n .tag:not(body).is-link {\n background-color: #d90052;\n color: #fff; }\n .tag:not(body).is-info {\n background-color: #0075cc;\n color: #fff; }\n .tag:not(body).is-success {\n background-color: #11ad74;\n color: rgba(0, 0, 0, 0.7); }\n .tag:not(body).is-warning {\n background-color: #ccba00;\n color: rgba(0, 0, 0, 0.7); }\n .tag:not(body).is-danger {\n background-color: #ee1742;\n color: #fff; }\n .tag:not(body).is-white-dark {\n background-color: white;\n color: #0a0a0a; }\n .tag:not(body).is-black-dark {\n background-color: #0a0a0a;\n color: white; }\n .tag:not(body).is-light-dark {\n background-color: whitesmoke;\n color: rgba(0, 0, 0, 0.7); }\n .tag:not(body).is-dark-dark {\n background-color: #363636;\n color: #fff; }\n .tag:not(body).is-primary-dark {\n background-color: #ff0d68;\n color: #fff; }\n .tag:not(body).is-link-dark {\n background-color: #ff0d68;\n color: #fff; }\n .tag:not(body).is-info-dark {\n background-color: #0092FF;\n color: #fff; }\n .tag:not(body).is-success-dark {\n background-color: #16DB93;\n color: rgba(0, 0, 0, 0.7); }\n .tag:not(body).is-warning-dark {\n background-color: #FFE900;\n color: rgba(0, 0, 0, 0.7); }\n .tag:not(body).is-danger-dark {\n background-color: #f14668;\n color: #fff; }\n .tag:not(body).is-delete:hover, .tag:not(body).is-delete:focus {\n background-color: #171717; }\n .tag:not(body).is-delete:active {\n background-color: #0a0a0a; }\n .title {\n color: #dbdbdb; }\n .subtitle {\n color: #b5b5b5; }\n .subtitle strong {\n color: #dbdbdb; }\n .number {\n background-color: #242424; }\n .breadcrumb a {\n color: #e60056; }\n .breadcrumb a:hover {\n color: #dbdbdb; }\n .breadcrumb li.is-active a {\n color: #dbdbdb; }\n .breadcrumb li + li::before {\n color: #4a4a4a; }\n .card {\n background-color: #0a0a0a;\n box-shadow: 0 2px 3px rgba(255, 255, 255, 0.1), 0 0 0 1px rgba(255, 255, 255, 0.1);\n color: #b5b5b5; }\n .card-header {\n box-shadow: 0 1px 2px rgba(255, 255, 255, 0.1); }\n .card-header-title {\n color: #dbdbdb; }\n .card-footer {\n border-top: 1px solid #363636; }\n .card-footer-item:not(:last-child) {\n border-right: 1px solid #363636; }\n .dropdown-content {\n background-color: #0a0a0a;\n box-shadow: 0 2px 3px rgba(255, 255, 255, 0.1), 0 0 0 1px rgba(255, 255, 255, 0.1); }\n .dropdown-item {\n color: #b5b5b5; }\n a.dropdown-item:hover,\n button.dropdown-item:hover {\n background-color: #242424;\n color: white; }\n a.dropdown-item.is-active,\n button.dropdown-item.is-active {\n background-color: #e60056;\n color: #fff; }\n .dropdown-divider {\n background-color: #363636; }\n .list {\n background-color: #0a0a0a;\n box-shadow: 0 2px 3px rgba(255, 255, 255, 0.1), 0 0 0 1px rgba(255, 255, 255, 0.1); }\n .list-item:not(a) {\n color: #b5b5b5; }\n .list-item:not(:last-child) {\n border-bottom: 1px solid #363636; }\n .list-item.is-active {\n background-color: #e60056;\n color: #fff; }\n a.list-item {\n background-color: #242424; }\n .media .media {\n border-top: 1px solid rgba(54, 54, 54, 0.5); }\n .media + .media {\n border-top: 1px solid rgba(54, 54, 54, 0.5); }\n .menu-list a {\n color: #b5b5b5; }\n .menu-list a:hover {\n background-color: #242424;\n color: #dbdbdb; }\n .menu-list a.is-active {\n background-color: #e60056;\n color: #fff; }\n .menu-list li ul {\n border-left: 1px solid #363636; }\n .message {\n background-color: #242424; }\n .message.is-white {\n background-color: #242424; }\n .message.is-white .message-header {\n background-color: white;\n color: #0a0a0a; }\n .message.is-white .message-body {\n border-color: white;\n color: #b5b5b5; }\n .message.is-black {\n background-color: #242424; }\n .message.is-black .message-header {\n background-color: #0a0a0a;\n color: white; }\n .message.is-black .message-body {\n border-color: #0a0a0a;\n color: #b5b5b5; }\n .message.is-light {\n background-color: #242424; }\n .message.is-light .message-header {\n background-color: whitesmoke;\n color: rgba(0, 0, 0, 0.7); }\n .message.is-light .message-body {\n border-color: whitesmoke;\n color: #b5b5b5; }\n .message.is-dark {\n background-color: #242424; }\n .message.is-dark .message-header {\n background-color: #363636;\n color: #fff; }\n .message.is-dark .message-body {\n border-color: #363636;\n color: #b5b5b5; }\n .message.is-primary {\n background-color: #242424; }\n .message.is-primary .message-header {\n background-color: #ff0d68;\n color: #fff; }\n .message.is-primary .message-body {\n border-color: #ff0d68;\n color: #b5b5b5; }\n .message.is-link {\n background-color: #242424; }\n .message.is-link .message-header {\n background-color: #ff0d68;\n color: #fff; }\n .message.is-link .message-body {\n border-color: #ff0d68;\n color: #b5b5b5; }\n .message.is-info {\n background-color: #242424; }\n .message.is-info .message-header {\n background-color: #0092FF;\n color: #fff; }\n .message.is-info .message-body {\n border-color: #0092FF;\n color: #b5b5b5; }\n .message.is-success {\n background-color: #242424; }\n .message.is-success .message-header {\n background-color: #16DB93;\n color: rgba(0, 0, 0, 0.7); }\n .message.is-success .message-body {\n border-color: #16DB93;\n color: #b5b5b5; }\n .message.is-warning {\n background-color: #242424; }\n .message.is-warning .message-header {\n background-color: #FFE900;\n color: rgba(0, 0, 0, 0.7); }\n .message.is-warning .message-body {\n border-color: #FFE900;\n color: #b5b5b5; }\n .message.is-danger {\n background-color: #242424; }\n .message.is-danger .message-header {\n background-color: #f14668;\n color: #fff; }\n .message.is-danger .message-body {\n border-color: #f14668;\n color: #b5b5b5; }\n .message.is-white-dark {\n background-color: #242424; }\n .message.is-white-dark .message-header {\n background-color: white;\n color: #0a0a0a; }\n .message.is-white-dark .message-body {\n border-color: white;\n color: #b5b5b5; }\n .message.is-black-dark {\n background-color: #242424; }\n .message.is-black-dark .message-header {\n background-color: #0a0a0a;\n color: white; }\n .message.is-black-dark .message-body {\n border-color: #0a0a0a;\n color: #b5b5b5; }\n .message.is-light-dark {\n background-color: #242424; }\n .message.is-light-dark .message-header {\n background-color: whitesmoke;\n color: rgba(0, 0, 0, 0.7); }\n .message.is-light-dark .message-body {\n border-color: whitesmoke;\n color: #b5b5b5; }\n .message.is-dark-dark {\n background-color: #242424; }\n .message.is-dark-dark .message-header {\n background-color: #363636;\n color: #fff; }\n .message.is-dark-dark .message-body {\n border-color: #363636;\n color: #b5b5b5; }\n .message.is-primary-dark {\n background-color: #242424; }\n .message.is-primary-dark .message-header {\n background-color: #ff0d68;\n color: #fff; }\n .message.is-primary-dark .message-body {\n border-color: #ff0d68;\n color: #b5b5b5; }\n .message.is-link-dark {\n background-color: #242424; }\n .message.is-link-dark .message-header {\n background-color: #ff0d68;\n color: #fff; }\n .message.is-link-dark .message-body {\n border-color: #ff0d68;\n color: #b5b5b5; }\n .message.is-info-dark {\n background-color: #242424; }\n .message.is-info-dark .message-header {\n background-color: #0092FF;\n color: #fff; }\n .message.is-info-dark .message-body {\n border-color: #0092FF;\n color: #b5b5b5; }\n .message.is-success-dark {\n background-color: #242424; }\n .message.is-success-dark .message-header {\n background-color: #16DB93;\n color: rgba(0, 0, 0, 0.7); }\n .message.is-success-dark .message-body {\n border-color: #16DB93;\n color: #b5b5b5; }\n .message.is-warning-dark {\n background-color: #242424; }\n .message.is-warning-dark .message-header {\n background-color: #FFE900;\n color: rgba(0, 0, 0, 0.7); }\n .message.is-warning-dark .message-body {\n border-color: #FFE900;\n color: #b5b5b5; }\n .message.is-danger-dark {\n background-color: #242424; }\n .message.is-danger-dark .message-header {\n background-color: #f14668;\n color: #fff; }\n .message.is-danger-dark .message-body {\n border-color: #f14668;\n color: #b5b5b5; }\n .message-header {\n background-color: #b5b5b5;\n color: #fff; }\n .message-body {\n border-color: #363636;\n color: #b5b5b5; }\n .message-body code,\n .message-body pre {\n background-color: #0a0a0a; }\n .modal-background {\n background-color: rgba(255, 255, 255, 0.86); }\n .modal-card-head,\n .modal-card-foot {\n background-color: #242424; }\n .modal-card-head {\n border-bottom: 1px solid #363636; }\n .modal-card-title {\n color: #dbdbdb; }\n .modal-card-foot {\n border-top: 1px solid #363636; }\n .modal-card-body {\n -webkit-overflow-scrolling: touch;\n background-color: white; }\n .navbar {\n background-color: #17181c; }\n .navbar.is-white {\n background-color: #e6e6e6;\n color: #0a0a0a; }\n .navbar.is-white .navbar-brand > .navbar-item,\n .navbar.is-white .navbar-brand .navbar-link {\n color: #0a0a0a; }\n .navbar.is-white .navbar-brand > a.navbar-item:hover, .navbar.is-white .navbar-brand > a.navbar-item.is-active,\n .navbar.is-white .navbar-brand .navbar-link:hover,\n .navbar.is-white .navbar-brand .navbar-link.is-active {\n background-color: #d9d9d9;\n color: #0a0a0a; }\n .navbar.is-white .navbar-brand .navbar-link::after {\n border-color: #0a0a0a; }\n .navbar.is-white .navbar-burger {\n color: #0a0a0a; } }\n @media screen and (prefers-color-scheme: dark) and (min-width: 1024px) {\n .navbar.is-white .navbar-start > .navbar-item,\n .navbar.is-white .navbar-start .navbar-link,\n .navbar.is-white .navbar-end > .navbar-item,\n .navbar.is-white .navbar-end .navbar-link {\n color: #0a0a0a; }\n .navbar.is-white .navbar-start > a.navbar-item:hover, .navbar.is-white .navbar-start > a.navbar-item.is-active,\n .navbar.is-white .navbar-start .navbar-link:hover,\n .navbar.is-white .navbar-start .navbar-link.is-active,\n .navbar.is-white .navbar-end > a.navbar-item:hover,\n .navbar.is-white .navbar-end > a.navbar-item.is-active,\n .navbar.is-white .navbar-end .navbar-link:hover,\n .navbar.is-white .navbar-end .navbar-link.is-active {\n background-color: #d9d9d9;\n color: #0a0a0a; }\n .navbar.is-white .navbar-start .navbar-link::after,\n .navbar.is-white .navbar-end .navbar-link::after {\n border-color: #0a0a0a; }\n .navbar.is-white .navbar-item.has-dropdown:hover .navbar-link,\n .navbar.is-white .navbar-item.has-dropdown.is-active .navbar-link {\n background-color: #d9d9d9;\n color: #0a0a0a; }\n .navbar.is-white .navbar-dropdown a.navbar-item.is-active {\n background-color: #e6e6e6;\n color: #0a0a0a; } }\n@media (prefers-color-scheme: dark) {\n .navbar.is-black {\n background-color: black;\n color: white; }\n .navbar.is-black .navbar-brand > .navbar-item,\n .navbar.is-black .navbar-brand .navbar-link {\n color: white; }\n .navbar.is-black .navbar-brand > a.navbar-item:hover, .navbar.is-black .navbar-brand > a.navbar-item.is-active,\n .navbar.is-black .navbar-brand .navbar-link:hover,\n .navbar.is-black .navbar-brand .navbar-link.is-active {\n background-color: black;\n color: white; }\n .navbar.is-black .navbar-brand .navbar-link::after {\n border-color: white; }\n .navbar.is-black .navbar-burger {\n color: white; } }\n @media screen and (prefers-color-scheme: dark) and (min-width: 1024px) {\n .navbar.is-black .navbar-start > .navbar-item,\n .navbar.is-black .navbar-start .navbar-link,\n .navbar.is-black .navbar-end > .navbar-item,\n .navbar.is-black .navbar-end .navbar-link {\n color: white; }\n .navbar.is-black .navbar-start > a.navbar-item:hover, .navbar.is-black .navbar-start > a.navbar-item.is-active,\n .navbar.is-black .navbar-start .navbar-link:hover,\n .navbar.is-black .navbar-start .navbar-link.is-active,\n .navbar.is-black .navbar-end > a.navbar-item:hover,\n .navbar.is-black .navbar-end > a.navbar-item.is-active,\n .navbar.is-black .navbar-end .navbar-link:hover,\n .navbar.is-black .navbar-end .navbar-link.is-active {\n background-color: black;\n color: white; }\n .navbar.is-black .navbar-start .navbar-link::after,\n .navbar.is-black .navbar-end .navbar-link::after {\n border-color: white; }\n .navbar.is-black .navbar-item.has-dropdown:hover .navbar-link,\n .navbar.is-black .navbar-item.has-dropdown.is-active .navbar-link {\n background-color: black;\n color: white; }\n .navbar.is-black .navbar-dropdown a.navbar-item.is-active {\n background-color: black;\n color: white; } }\n@media (prefers-color-scheme: dark) {\n .navbar.is-light {\n background-color: #dbdbdb;\n color: rgba(0, 0, 0, 0.7); }\n .navbar.is-light .navbar-brand > .navbar-item,\n .navbar.is-light .navbar-brand .navbar-link {\n color: rgba(0, 0, 0, 0.7); }\n .navbar.is-light .navbar-brand > a.navbar-item:hover, .navbar.is-light .navbar-brand > a.navbar-item.is-active,\n .navbar.is-light .navbar-brand .navbar-link:hover,\n .navbar.is-light .navbar-brand .navbar-link.is-active {\n background-color: #cfcfcf;\n color: rgba(0, 0, 0, 0.7); }\n .navbar.is-light .navbar-brand .navbar-link::after {\n border-color: rgba(0, 0, 0, 0.7); }\n .navbar.is-light .navbar-burger {\n color: rgba(0, 0, 0, 0.7); } }\n @media screen and (prefers-color-scheme: dark) and (min-width: 1024px) {\n .navbar.is-light .navbar-start > .navbar-item,\n .navbar.is-light .navbar-start .navbar-link,\n .navbar.is-light .navbar-end > .navbar-item,\n .navbar.is-light .navbar-end .navbar-link {\n color: rgba(0, 0, 0, 0.7); }\n .navbar.is-light .navbar-start > a.navbar-item:hover, .navbar.is-light .navbar-start > a.navbar-item.is-active,\n .navbar.is-light .navbar-start .navbar-link:hover,\n .navbar.is-light .navbar-start .navbar-link.is-active,\n .navbar.is-light .navbar-end > a.navbar-item:hover,\n .navbar.is-light .navbar-end > a.navbar-item.is-active,\n .navbar.is-light .navbar-end .navbar-link:hover,\n .navbar.is-light .navbar-end .navbar-link.is-active {\n background-color: #cfcfcf;\n color: rgba(0, 0, 0, 0.7); }\n .navbar.is-light .navbar-start .navbar-link::after,\n .navbar.is-light .navbar-end .navbar-link::after {\n border-color: rgba(0, 0, 0, 0.7); }\n .navbar.is-light .navbar-item.has-dropdown:hover .navbar-link,\n .navbar.is-light .navbar-item.has-dropdown.is-active .navbar-link {\n background-color: #cfcfcf;\n color: rgba(0, 0, 0, 0.7); }\n .navbar.is-light .navbar-dropdown a.navbar-item.is-active {\n background-color: #dbdbdb;\n color: rgba(0, 0, 0, 0.7); } }\n@media (prefers-color-scheme: dark) {\n .navbar.is-dark {\n background-color: #1c1c1c;\n color: #fff; }\n .navbar.is-dark .navbar-brand > .navbar-item,\n .navbar.is-dark .navbar-brand .navbar-link {\n color: #fff; }\n .navbar.is-dark .navbar-brand > a.navbar-item:hover, .navbar.is-dark .navbar-brand > a.navbar-item.is-active,\n .navbar.is-dark .navbar-brand .navbar-link:hover,\n .navbar.is-dark .navbar-brand .navbar-link.is-active {\n background-color: #0f0f0f;\n color: #fff; }\n .navbar.is-dark .navbar-brand .navbar-link::after {\n border-color: #fff; }\n .navbar.is-dark .navbar-burger {\n color: #fff; } }\n @media screen and (prefers-color-scheme: dark) and (min-width: 1024px) {\n .navbar.is-dark .navbar-start > .navbar-item,\n .navbar.is-dark .navbar-start .navbar-link,\n .navbar.is-dark .navbar-end > .navbar-item,\n .navbar.is-dark .navbar-end .navbar-link {\n color: #fff; }\n .navbar.is-dark .navbar-start > a.navbar-item:hover, .navbar.is-dark .navbar-start > a.navbar-item.is-active,\n .navbar.is-dark .navbar-start .navbar-link:hover,\n .navbar.is-dark .navbar-start .navbar-link.is-active,\n .navbar.is-dark .navbar-end > a.navbar-item:hover,\n .navbar.is-dark .navbar-end > a.navbar-item.is-active,\n .navbar.is-dark .navbar-end .navbar-link:hover,\n .navbar.is-dark .navbar-end .navbar-link.is-active {\n background-color: #0f0f0f;\n color: #fff; }\n .navbar.is-dark .navbar-start .navbar-link::after,\n .navbar.is-dark .navbar-end .navbar-link::after {\n border-color: #fff; }\n .navbar.is-dark .navbar-item.has-dropdown:hover .navbar-link,\n .navbar.is-dark .navbar-item.has-dropdown.is-active .navbar-link {\n background-color: #0f0f0f;\n color: #fff; }\n .navbar.is-dark .navbar-dropdown a.navbar-item.is-active {\n background-color: #1c1c1c;\n color: #fff; } }\n@media (prefers-color-scheme: dark) {\n .navbar.is-primary {\n background-color: #d90052;\n color: #fff; }\n .navbar.is-primary .navbar-brand > .navbar-item,\n .navbar.is-primary .navbar-brand .navbar-link {\n color: #fff; }\n .navbar.is-primary .navbar-brand > a.navbar-item:hover, .navbar.is-primary .navbar-brand > a.navbar-item.is-active,\n .navbar.is-primary .navbar-brand .navbar-link:hover,\n .navbar.is-primary .navbar-brand .navbar-link.is-active {\n background-color: #c00048;\n color: #fff; }\n .navbar.is-primary .navbar-brand .navbar-link::after {\n border-color: #fff; }\n .navbar.is-primary .navbar-burger {\n color: #fff; } }\n @media screen and (prefers-color-scheme: dark) and (min-width: 1024px) {\n .navbar.is-primary .navbar-start > .navbar-item,\n .navbar.is-primary .navbar-start .navbar-link,\n .navbar.is-primary .navbar-end > .navbar-item,\n .navbar.is-primary .navbar-end .navbar-link {\n color: #fff; }\n .navbar.is-primary .navbar-start > a.navbar-item:hover, .navbar.is-primary .navbar-start > a.navbar-item.is-active,\n .navbar.is-primary .navbar-start .navbar-link:hover,\n .navbar.is-primary .navbar-start .navbar-link.is-active,\n .navbar.is-primary .navbar-end > a.navbar-item:hover,\n .navbar.is-primary .navbar-end > a.navbar-item.is-active,\n .navbar.is-primary .navbar-end .navbar-link:hover,\n .navbar.is-primary .navbar-end .navbar-link.is-active {\n background-color: #c00048;\n color: #fff; }\n .navbar.is-primary .navbar-start .navbar-link::after,\n .navbar.is-primary .navbar-end .navbar-link::after {\n border-color: #fff; }\n .navbar.is-primary .navbar-item.has-dropdown:hover .navbar-link,\n .navbar.is-primary .navbar-item.has-dropdown.is-active .navbar-link {\n background-color: #c00048;\n color: #fff; }\n .navbar.is-primary .navbar-dropdown a.navbar-item.is-active {\n background-color: #d90052;\n color: #fff; } }\n@media (prefers-color-scheme: dark) {\n .navbar.is-link {\n background-color: #d90052;\n color: #fff; }\n .navbar.is-link .navbar-brand > .navbar-item,\n .navbar.is-link .navbar-brand .navbar-link {\n color: #fff; }\n .navbar.is-link .navbar-brand > a.navbar-item:hover, .navbar.is-link .navbar-brand > a.navbar-item.is-active,\n .navbar.is-link .navbar-brand .navbar-link:hover,\n .navbar.is-link .navbar-brand .navbar-link.is-active {\n background-color: #c00048;\n color: #fff; }\n .navbar.is-link .navbar-brand .navbar-link::after {\n border-color: #fff; }\n .navbar.is-link .navbar-burger {\n color: #fff; } }\n @media screen and (prefers-color-scheme: dark) and (min-width: 1024px) {\n .navbar.is-link .navbar-start > .navbar-item,\n .navbar.is-link .navbar-start .navbar-link,\n .navbar.is-link .navbar-end > .navbar-item,\n .navbar.is-link .navbar-end .navbar-link {\n color: #fff; }\n .navbar.is-link .navbar-start > a.navbar-item:hover, .navbar.is-link .navbar-start > a.navbar-item.is-active,\n .navbar.is-link .navbar-start .navbar-link:hover,\n .navbar.is-link .navbar-start .navbar-link.is-active,\n .navbar.is-link .navbar-end > a.navbar-item:hover,\n .navbar.is-link .navbar-end > a.navbar-item.is-active,\n .navbar.is-link .navbar-end .navbar-link:hover,\n .navbar.is-link .navbar-end .navbar-link.is-active {\n background-color: #c00048;\n color: #fff; }\n .navbar.is-link .navbar-start .navbar-link::after,\n .navbar.is-link .navbar-end .navbar-link::after {\n border-color: #fff; }\n .navbar.is-link .navbar-item.has-dropdown:hover .navbar-link,\n .navbar.is-link .navbar-item.has-dropdown.is-active .navbar-link {\n background-color: #c00048;\n color: #fff; }\n .navbar.is-link .navbar-dropdown a.navbar-item.is-active {\n background-color: #d90052;\n color: #fff; } }\n@media (prefers-color-scheme: dark) {\n .navbar.is-info {\n background-color: #0075cc;\n color: #fff; }\n .navbar.is-info .navbar-brand > .navbar-item,\n .navbar.is-info .navbar-brand .navbar-link {\n color: #fff; }\n .navbar.is-info .navbar-brand > a.navbar-item:hover, .navbar.is-info .navbar-brand > a.navbar-item.is-active,\n .navbar.is-info .navbar-brand .navbar-link:hover,\n .navbar.is-info .navbar-brand .navbar-link.is-active {\n background-color: #0066b3;\n color: #fff; }\n .navbar.is-info .navbar-brand .navbar-link::after {\n border-color: #fff; }\n .navbar.is-info .navbar-burger {\n color: #fff; } }\n @media screen and (prefers-color-scheme: dark) and (min-width: 1024px) {\n .navbar.is-info .navbar-start > .navbar-item,\n .navbar.is-info .navbar-start .navbar-link,\n .navbar.is-info .navbar-end > .navbar-item,\n .navbar.is-info .navbar-end .navbar-link {\n color: #fff; }\n .navbar.is-info .navbar-start > a.navbar-item:hover, .navbar.is-info .navbar-start > a.navbar-item.is-active,\n .navbar.is-info .navbar-start .navbar-link:hover,\n .navbar.is-info .navbar-start .navbar-link.is-active,\n .navbar.is-info .navbar-end > a.navbar-item:hover,\n .navbar.is-info .navbar-end > a.navbar-item.is-active,\n .navbar.is-info .navbar-end .navbar-link:hover,\n .navbar.is-info .navbar-end .navbar-link.is-active {\n background-color: #0066b3;\n color: #fff; }\n .navbar.is-info .navbar-start .navbar-link::after,\n .navbar.is-info .navbar-end .navbar-link::after {\n border-color: #fff; }\n .navbar.is-info .navbar-item.has-dropdown:hover .navbar-link,\n .navbar.is-info .navbar-item.has-dropdown.is-active .navbar-link {\n background-color: #0066b3;\n color: #fff; }\n .navbar.is-info .navbar-dropdown a.navbar-item.is-active {\n background-color: #0075cc;\n color: #fff; } }\n@media (prefers-color-scheme: dark) {\n .navbar.is-success {\n background-color: #11ad74;\n color: rgba(0, 0, 0, 0.7); }\n .navbar.is-success .navbar-brand > .navbar-item,\n .navbar.is-success .navbar-brand .navbar-link {\n color: rgba(0, 0, 0, 0.7); }\n .navbar.is-success .navbar-brand > a.navbar-item:hover, .navbar.is-success .navbar-brand > a.navbar-item.is-active,\n .navbar.is-success .navbar-brand .navbar-link:hover,\n .navbar.is-success .navbar-brand .navbar-link.is-active {\n background-color: #0f9564;\n color: rgba(0, 0, 0, 0.7); }\n .navbar.is-success .navbar-brand .navbar-link::after {\n border-color: rgba(0, 0, 0, 0.7); }\n .navbar.is-success .navbar-burger {\n color: rgba(0, 0, 0, 0.7); } }\n @media screen and (prefers-color-scheme: dark) and (min-width: 1024px) {\n .navbar.is-success .navbar-start > .navbar-item,\n .navbar.is-success .navbar-start .navbar-link,\n .navbar.is-success .navbar-end > .navbar-item,\n .navbar.is-success .navbar-end .navbar-link {\n color: rgba(0, 0, 0, 0.7); }\n .navbar.is-success .navbar-start > a.navbar-item:hover, .navbar.is-success .navbar-start > a.navbar-item.is-active,\n .navbar.is-success .navbar-start .navbar-link:hover,\n .navbar.is-success .navbar-start .navbar-link.is-active,\n .navbar.is-success .navbar-end > a.navbar-item:hover,\n .navbar.is-success .navbar-end > a.navbar-item.is-active,\n .navbar.is-success .navbar-end .navbar-link:hover,\n .navbar.is-success .navbar-end .navbar-link.is-active {\n background-color: #0f9564;\n color: rgba(0, 0, 0, 0.7); }\n .navbar.is-success .navbar-start .navbar-link::after,\n .navbar.is-success .navbar-end .navbar-link::after {\n border-color: rgba(0, 0, 0, 0.7); }\n .navbar.is-success .navbar-item.has-dropdown:hover .navbar-link,\n .navbar.is-success .navbar-item.has-dropdown.is-active .navbar-link {\n background-color: #0f9564;\n color: rgba(0, 0, 0, 0.7); }\n .navbar.is-success .navbar-dropdown a.navbar-item.is-active {\n background-color: #11ad74;\n color: rgba(0, 0, 0, 0.7); } }\n@media (prefers-color-scheme: dark) {\n .navbar.is-warning {\n background-color: #ccba00;\n color: rgba(0, 0, 0, 0.7); }\n .navbar.is-warning .navbar-brand > .navbar-item,\n .navbar.is-warning .navbar-brand .navbar-link {\n color: rgba(0, 0, 0, 0.7); }\n .navbar.is-warning .navbar-brand > a.navbar-item:hover, .navbar.is-warning .navbar-brand > a.navbar-item.is-active,\n .navbar.is-warning .navbar-brand .navbar-link:hover,\n .navbar.is-warning .navbar-brand .navbar-link.is-active {\n background-color: #b3a300;\n color: rgba(0, 0, 0, 0.7); }\n .navbar.is-warning .navbar-brand .navbar-link::after {\n border-color: rgba(0, 0, 0, 0.7); }\n .navbar.is-warning .navbar-burger {\n color: rgba(0, 0, 0, 0.7); } }\n @media screen and (prefers-color-scheme: dark) and (min-width: 1024px) {\n .navbar.is-warning .navbar-start > .navbar-item,\n .navbar.is-warning .navbar-start .navbar-link,\n .navbar.is-warning .navbar-end > .navbar-item,\n .navbar.is-warning .navbar-end .navbar-link {\n color: rgba(0, 0, 0, 0.7); }\n .navbar.is-warning .navbar-start > a.navbar-item:hover, .navbar.is-warning .navbar-start > a.navbar-item.is-active,\n .navbar.is-warning .navbar-start .navbar-link:hover,\n .navbar.is-warning .navbar-start .navbar-link.is-active,\n .navbar.is-warning .navbar-end > a.navbar-item:hover,\n .navbar.is-warning .navbar-end > a.navbar-item.is-active,\n .navbar.is-warning .navbar-end .navbar-link:hover,\n .navbar.is-warning .navbar-end .navbar-link.is-active {\n background-color: #b3a300;\n color: rgba(0, 0, 0, 0.7); }\n .navbar.is-warning .navbar-start .navbar-link::after,\n .navbar.is-warning .navbar-end .navbar-link::after {\n border-color: rgba(0, 0, 0, 0.7); }\n .navbar.is-warning .navbar-item.has-dropdown:hover .navbar-link,\n .navbar.is-warning .navbar-item.has-dropdown.is-active .navbar-link {\n background-color: #b3a300;\n color: rgba(0, 0, 0, 0.7); }\n .navbar.is-warning .navbar-dropdown a.navbar-item.is-active {\n background-color: #ccba00;\n color: rgba(0, 0, 0, 0.7); } }\n@media (prefers-color-scheme: dark) {\n .navbar.is-danger {\n background-color: #ee1742;\n color: #fff; }\n .navbar.is-danger .navbar-brand > .navbar-item,\n .navbar.is-danger .navbar-brand .navbar-link {\n color: #fff; }\n .navbar.is-danger .navbar-brand > a.navbar-item:hover, .navbar.is-danger .navbar-brand > a.navbar-item.is-active,\n .navbar.is-danger .navbar-brand .navbar-link:hover,\n .navbar.is-danger .navbar-brand .navbar-link.is-active {\n background-color: #da1039;\n color: #fff; }\n .navbar.is-danger .navbar-brand .navbar-link::after {\n border-color: #fff; }\n .navbar.is-danger .navbar-burger {\n color: #fff; } }\n @media screen and (prefers-color-scheme: dark) and (min-width: 1024px) {\n .navbar.is-danger .navbar-start > .navbar-item,\n .navbar.is-danger .navbar-start .navbar-link,\n .navbar.is-danger .navbar-end > .navbar-item,\n .navbar.is-danger .navbar-end .navbar-link {\n color: #fff; }\n .navbar.is-danger .navbar-start > a.navbar-item:hover, .navbar.is-danger .navbar-start > a.navbar-item.is-active,\n .navbar.is-danger .navbar-start .navbar-link:hover,\n .navbar.is-danger .navbar-start .navbar-link.is-active,\n .navbar.is-danger .navbar-end > a.navbar-item:hover,\n .navbar.is-danger .navbar-end > a.navbar-item.is-active,\n .navbar.is-danger .navbar-end .navbar-link:hover,\n .navbar.is-danger .navbar-end .navbar-link.is-active {\n background-color: #da1039;\n color: #fff; }\n .navbar.is-danger .navbar-start .navbar-link::after,\n .navbar.is-danger .navbar-end .navbar-link::after {\n border-color: #fff; }\n .navbar.is-danger .navbar-item.has-dropdown:hover .navbar-link,\n .navbar.is-danger .navbar-item.has-dropdown.is-active .navbar-link {\n background-color: #da1039;\n color: #fff; }\n .navbar.is-danger .navbar-dropdown a.navbar-item.is-active {\n background-color: #ee1742;\n color: #fff; } }\n@media (prefers-color-scheme: dark) {\n .navbar.is-white-dark {\n background-color: white;\n color: #0a0a0a; }\n .navbar.is-white-dark .navbar-brand > .navbar-item,\n .navbar.is-white-dark .navbar-brand .navbar-link {\n color: #0a0a0a; }\n .navbar.is-white-dark .navbar-brand > a.navbar-item:hover, .navbar.is-white-dark .navbar-brand > a.navbar-item.is-active,\n .navbar.is-white-dark .navbar-brand .navbar-link:hover,\n .navbar.is-white-dark .navbar-brand .navbar-link.is-active {\n background-color: #f2f2f2;\n color: #0a0a0a; }\n .navbar.is-white-dark .navbar-brand .navbar-link::after {\n border-color: #0a0a0a; }\n .navbar.is-white-dark .navbar-burger {\n color: #0a0a0a; } }\n @media screen and (prefers-color-scheme: dark) and (min-width: 1024px) {\n .navbar.is-white-dark .navbar-start > .navbar-item,\n .navbar.is-white-dark .navbar-start .navbar-link,\n .navbar.is-white-dark .navbar-end > .navbar-item,\n .navbar.is-white-dark .navbar-end .navbar-link {\n color: #0a0a0a; }\n .navbar.is-white-dark .navbar-start > a.navbar-item:hover, .navbar.is-white-dark .navbar-start > a.navbar-item.is-active,\n .navbar.is-white-dark .navbar-start .navbar-link:hover,\n .navbar.is-white-dark .navbar-start .navbar-link.is-active,\n .navbar.is-white-dark .navbar-end > a.navbar-item:hover,\n .navbar.is-white-dark .navbar-end > a.navbar-item.is-active,\n .navbar.is-white-dark .navbar-end .navbar-link:hover,\n .navbar.is-white-dark .navbar-end .navbar-link.is-active {\n background-color: #f2f2f2;\n color: #0a0a0a; }\n .navbar.is-white-dark .navbar-start .navbar-link::after,\n .navbar.is-white-dark .navbar-end .navbar-link::after {\n border-color: #0a0a0a; }\n .navbar.is-white-dark .navbar-item.has-dropdown:hover .navbar-link,\n .navbar.is-white-dark .navbar-item.has-dropdown.is-active .navbar-link {\n background-color: #f2f2f2;\n color: #0a0a0a; }\n .navbar.is-white-dark .navbar-dropdown a.navbar-item.is-active {\n background-color: white;\n color: #0a0a0a; } }\n@media (prefers-color-scheme: dark) {\n .navbar.is-black-dark {\n background-color: #0a0a0a;\n color: white; }\n .navbar.is-black-dark .navbar-brand > .navbar-item,\n .navbar.is-black-dark .navbar-brand .navbar-link {\n color: white; }\n .navbar.is-black-dark .navbar-brand > a.navbar-item:hover, .navbar.is-black-dark .navbar-brand > a.navbar-item.is-active,\n .navbar.is-black-dark .navbar-brand .navbar-link:hover,\n .navbar.is-black-dark .navbar-brand .navbar-link.is-active {\n background-color: black;\n color: white; }\n .navbar.is-black-dark .navbar-brand .navbar-link::after {\n border-color: white; }\n .navbar.is-black-dark .navbar-burger {\n color: white; } }\n @media screen and (prefers-color-scheme: dark) and (min-width: 1024px) {\n .navbar.is-black-dark .navbar-start > .navbar-item,\n .navbar.is-black-dark .navbar-start .navbar-link,\n .navbar.is-black-dark .navbar-end > .navbar-item,\n .navbar.is-black-dark .navbar-end .navbar-link {\n color: white; }\n .navbar.is-black-dark .navbar-start > a.navbar-item:hover, .navbar.is-black-dark .navbar-start > a.navbar-item.is-active,\n .navbar.is-black-dark .navbar-start .navbar-link:hover,\n .navbar.is-black-dark .navbar-start .navbar-link.is-active,\n .navbar.is-black-dark .navbar-end > a.navbar-item:hover,\n .navbar.is-black-dark .navbar-end > a.navbar-item.is-active,\n .navbar.is-black-dark .navbar-end .navbar-link:hover,\n .navbar.is-black-dark .navbar-end .navbar-link.is-active {\n background-color: black;\n color: white; }\n .navbar.is-black-dark .navbar-start .navbar-link::after,\n .navbar.is-black-dark .navbar-end .navbar-link::after {\n border-color: white; }\n .navbar.is-black-dark .navbar-item.has-dropdown:hover .navbar-link,\n .navbar.is-black-dark .navbar-item.has-dropdown.is-active .navbar-link {\n background-color: black;\n color: white; }\n .navbar.is-black-dark .navbar-dropdown a.navbar-item.is-active {\n background-color: #0a0a0a;\n color: white; } }\n@media (prefers-color-scheme: dark) {\n .navbar.is-light-dark {\n background-color: whitesmoke;\n color: rgba(0, 0, 0, 0.7); }\n .navbar.is-light-dark .navbar-brand > .navbar-item,\n .navbar.is-light-dark .navbar-brand .navbar-link {\n color: rgba(0, 0, 0, 0.7); }\n .navbar.is-light-dark .navbar-brand > a.navbar-item:hover, .navbar.is-light-dark .navbar-brand > a.navbar-item.is-active,\n .navbar.is-light-dark .navbar-brand .navbar-link:hover,\n .navbar.is-light-dark .navbar-brand .navbar-link.is-active {\n background-color: #e8e8e8;\n color: rgba(0, 0, 0, 0.7); }\n .navbar.is-light-dark .navbar-brand .navbar-link::after {\n border-color: rgba(0, 0, 0, 0.7); }\n .navbar.is-light-dark .navbar-burger {\n color: rgba(0, 0, 0, 0.7); } }\n @media screen and (prefers-color-scheme: dark) and (min-width: 1024px) {\n .navbar.is-light-dark .navbar-start > .navbar-item,\n .navbar.is-light-dark .navbar-start .navbar-link,\n .navbar.is-light-dark .navbar-end > .navbar-item,\n .navbar.is-light-dark .navbar-end .navbar-link {\n color: rgba(0, 0, 0, 0.7); }\n .navbar.is-light-dark .navbar-start > a.navbar-item:hover, .navbar.is-light-dark .navbar-start > a.navbar-item.is-active,\n .navbar.is-light-dark .navbar-start .navbar-link:hover,\n .navbar.is-light-dark .navbar-start .navbar-link.is-active,\n .navbar.is-light-dark .navbar-end > a.navbar-item:hover,\n .navbar.is-light-dark .navbar-end > a.navbar-item.is-active,\n .navbar.is-light-dark .navbar-end .navbar-link:hover,\n .navbar.is-light-dark .navbar-end .navbar-link.is-active {\n background-color: #e8e8e8;\n color: rgba(0, 0, 0, 0.7); }\n .navbar.is-light-dark .navbar-start .navbar-link::after,\n .navbar.is-light-dark .navbar-end .navbar-link::after {\n border-color: rgba(0, 0, 0, 0.7); }\n .navbar.is-light-dark .navbar-item.has-dropdown:hover .navbar-link,\n .navbar.is-light-dark .navbar-item.has-dropdown.is-active .navbar-link {\n background-color: #e8e8e8;\n color: rgba(0, 0, 0, 0.7); }\n .navbar.is-light-dark .navbar-dropdown a.navbar-item.is-active {\n background-color: whitesmoke;\n color: rgba(0, 0, 0, 0.7); } }\n@media (prefers-color-scheme: dark) {\n .navbar.is-dark-dark {\n background-color: #363636;\n color: #fff; }\n .navbar.is-dark-dark .navbar-brand > .navbar-item,\n .navbar.is-dark-dark .navbar-brand .navbar-link {\n color: #fff; }\n .navbar.is-dark-dark .navbar-brand > a.navbar-item:hover, .navbar.is-dark-dark .navbar-brand > a.navbar-item.is-active,\n .navbar.is-dark-dark .navbar-brand .navbar-link:hover,\n .navbar.is-dark-dark .navbar-brand .navbar-link.is-active {\n background-color: #292929;\n color: #fff; }\n .navbar.is-dark-dark .navbar-brand .navbar-link::after {\n border-color: #fff; }\n .navbar.is-dark-dark .navbar-burger {\n color: #fff; } }\n @media screen and (prefers-color-scheme: dark) and (min-width: 1024px) {\n .navbar.is-dark-dark .navbar-start > .navbar-item,\n .navbar.is-dark-dark .navbar-start .navbar-link,\n .navbar.is-dark-dark .navbar-end > .navbar-item,\n .navbar.is-dark-dark .navbar-end .navbar-link {\n color: #fff; }\n .navbar.is-dark-dark .navbar-start > a.navbar-item:hover, .navbar.is-dark-dark .navbar-start > a.navbar-item.is-active,\n .navbar.is-dark-dark .navbar-start .navbar-link:hover,\n .navbar.is-dark-dark .navbar-start .navbar-link.is-active,\n .navbar.is-dark-dark .navbar-end > a.navbar-item:hover,\n .navbar.is-dark-dark .navbar-end > a.navbar-item.is-active,\n .navbar.is-dark-dark .navbar-end .navbar-link:hover,\n .navbar.is-dark-dark .navbar-end .navbar-link.is-active {\n background-color: #292929;\n color: #fff; }\n .navbar.is-dark-dark .navbar-start .navbar-link::after,\n .navbar.is-dark-dark .navbar-end .navbar-link::after {\n border-color: #fff; }\n .navbar.is-dark-dark .navbar-item.has-dropdown:hover .navbar-link,\n .navbar.is-dark-dark .navbar-item.has-dropdown.is-active .navbar-link {\n background-color: #292929;\n color: #fff; }\n .navbar.is-dark-dark .navbar-dropdown a.navbar-item.is-active {\n background-color: #363636;\n color: #fff; } }\n@media (prefers-color-scheme: dark) {\n .navbar.is-primary-dark {\n background-color: #ff0d68;\n color: #fff; }\n .navbar.is-primary-dark .navbar-brand > .navbar-item,\n .navbar.is-primary-dark .navbar-brand .navbar-link {\n color: #fff; }\n .navbar.is-primary-dark .navbar-brand > a.navbar-item:hover, .navbar.is-primary-dark .navbar-brand > a.navbar-item.is-active,\n .navbar.is-primary-dark .navbar-brand .navbar-link:hover,\n .navbar.is-primary-dark .navbar-brand .navbar-link.is-active {\n background-color: #f3005b;\n color: #fff; }\n .navbar.is-primary-dark .navbar-brand .navbar-link::after {\n border-color: #fff; }\n .navbar.is-primary-dark .navbar-burger {\n color: #fff; } }\n @media screen and (prefers-color-scheme: dark) and (min-width: 1024px) {\n .navbar.is-primary-dark .navbar-start > .navbar-item,\n .navbar.is-primary-dark .navbar-start .navbar-link,\n .navbar.is-primary-dark .navbar-end > .navbar-item,\n .navbar.is-primary-dark .navbar-end .navbar-link {\n color: #fff; }\n .navbar.is-primary-dark .navbar-start > a.navbar-item:hover, .navbar.is-primary-dark .navbar-start > a.navbar-item.is-active,\n .navbar.is-primary-dark .navbar-start .navbar-link:hover,\n .navbar.is-primary-dark .navbar-start .navbar-link.is-active,\n .navbar.is-primary-dark .navbar-end > a.navbar-item:hover,\n .navbar.is-primary-dark .navbar-end > a.navbar-item.is-active,\n .navbar.is-primary-dark .navbar-end .navbar-link:hover,\n .navbar.is-primary-dark .navbar-end .navbar-link.is-active {\n background-color: #f3005b;\n color: #fff; }\n .navbar.is-primary-dark .navbar-start .navbar-link::after,\n .navbar.is-primary-dark .navbar-end .navbar-link::after {\n border-color: #fff; }\n .navbar.is-primary-dark .navbar-item.has-dropdown:hover .navbar-link,\n .navbar.is-primary-dark .navbar-item.has-dropdown.is-active .navbar-link {\n background-color: #f3005b;\n color: #fff; }\n .navbar.is-primary-dark .navbar-dropdown a.navbar-item.is-active {\n background-color: #ff0d68;\n color: #fff; } }\n@media (prefers-color-scheme: dark) {\n .navbar.is-link-dark {\n background-color: #ff0d68;\n color: #fff; }\n .navbar.is-link-dark .navbar-brand > .navbar-item,\n .navbar.is-link-dark .navbar-brand .navbar-link {\n color: #fff; }\n .navbar.is-link-dark .navbar-brand > a.navbar-item:hover, .navbar.is-link-dark .navbar-brand > a.navbar-item.is-active,\n .navbar.is-link-dark .navbar-brand .navbar-link:hover,\n .navbar.is-link-dark .navbar-brand .navbar-link.is-active {\n background-color: #f3005b;\n color: #fff; }\n .navbar.is-link-dark .navbar-brand .navbar-link::after {\n border-color: #fff; }\n .navbar.is-link-dark .navbar-burger {\n color: #fff; } }\n @media screen and (prefers-color-scheme: dark) and (min-width: 1024px) {\n .navbar.is-link-dark .navbar-start > .navbar-item,\n .navbar.is-link-dark .navbar-start .navbar-link,\n .navbar.is-link-dark .navbar-end > .navbar-item,\n .navbar.is-link-dark .navbar-end .navbar-link {\n color: #fff; }\n .navbar.is-link-dark .navbar-start > a.navbar-item:hover, .navbar.is-link-dark .navbar-start > a.navbar-item.is-active,\n .navbar.is-link-dark .navbar-start .navbar-link:hover,\n .navbar.is-link-dark .navbar-start .navbar-link.is-active,\n .navbar.is-link-dark .navbar-end > a.navbar-item:hover,\n .navbar.is-link-dark .navbar-end > a.navbar-item.is-active,\n .navbar.is-link-dark .navbar-end .navbar-link:hover,\n .navbar.is-link-dark .navbar-end .navbar-link.is-active {\n background-color: #f3005b;\n color: #fff; }\n .navbar.is-link-dark .navbar-start .navbar-link::after,\n .navbar.is-link-dark .navbar-end .navbar-link::after {\n border-color: #fff; }\n .navbar.is-link-dark .navbar-item.has-dropdown:hover .navbar-link,\n .navbar.is-link-dark .navbar-item.has-dropdown.is-active .navbar-link {\n background-color: #f3005b;\n color: #fff; }\n .navbar.is-link-dark .navbar-dropdown a.navbar-item.is-active {\n background-color: #ff0d68;\n color: #fff; } }\n@media (prefers-color-scheme: dark) {\n .navbar.is-info-dark {\n background-color: #0092FF;\n color: #fff; }\n .navbar.is-info-dark .navbar-brand > .navbar-item,\n .navbar.is-info-dark .navbar-brand .navbar-link {\n color: #fff; }\n .navbar.is-info-dark .navbar-brand > a.navbar-item:hover, .navbar.is-info-dark .navbar-brand > a.navbar-item.is-active,\n .navbar.is-info-dark .navbar-brand .navbar-link:hover,\n .navbar.is-info-dark .navbar-brand .navbar-link.is-active {\n background-color: #0083e6;\n color: #fff; }\n .navbar.is-info-dark .navbar-brand .navbar-link::after {\n border-color: #fff; }\n .navbar.is-info-dark .navbar-burger {\n color: #fff; } }\n @media screen and (prefers-color-scheme: dark) and (min-width: 1024px) {\n .navbar.is-info-dark .navbar-start > .navbar-item,\n .navbar.is-info-dark .navbar-start .navbar-link,\n .navbar.is-info-dark .navbar-end > .navbar-item,\n .navbar.is-info-dark .navbar-end .navbar-link {\n color: #fff; }\n .navbar.is-info-dark .navbar-start > a.navbar-item:hover, .navbar.is-info-dark .navbar-start > a.navbar-item.is-active,\n .navbar.is-info-dark .navbar-start .navbar-link:hover,\n .navbar.is-info-dark .navbar-start .navbar-link.is-active,\n .navbar.is-info-dark .navbar-end > a.navbar-item:hover,\n .navbar.is-info-dark .navbar-end > a.navbar-item.is-active,\n .navbar.is-info-dark .navbar-end .navbar-link:hover,\n .navbar.is-info-dark .navbar-end .navbar-link.is-active {\n background-color: #0083e6;\n color: #fff; }\n .navbar.is-info-dark .navbar-start .navbar-link::after,\n .navbar.is-info-dark .navbar-end .navbar-link::after {\n border-color: #fff; }\n .navbar.is-info-dark .navbar-item.has-dropdown:hover .navbar-link,\n .navbar.is-info-dark .navbar-item.has-dropdown.is-active .navbar-link {\n background-color: #0083e6;\n color: #fff; }\n .navbar.is-info-dark .navbar-dropdown a.navbar-item.is-active {\n background-color: #0092FF;\n color: #fff; } }\n@media (prefers-color-scheme: dark) {\n .navbar.is-success-dark {\n background-color: #16DB93;\n color: rgba(0, 0, 0, 0.7); }\n .navbar.is-success-dark .navbar-brand > .navbar-item,\n .navbar.is-success-dark .navbar-brand .navbar-link {\n color: rgba(0, 0, 0, 0.7); }\n .navbar.is-success-dark .navbar-brand > a.navbar-item:hover, .navbar.is-success-dark .navbar-brand > a.navbar-item.is-active,\n .navbar.is-success-dark .navbar-brand .navbar-link:hover,\n .navbar.is-success-dark .navbar-brand .navbar-link.is-active {\n background-color: #14c483;\n color: rgba(0, 0, 0, 0.7); }\n .navbar.is-success-dark .navbar-brand .navbar-link::after {\n border-color: rgba(0, 0, 0, 0.7); }\n .navbar.is-success-dark .navbar-burger {\n color: rgba(0, 0, 0, 0.7); } }\n @media screen and (prefers-color-scheme: dark) and (min-width: 1024px) {\n .navbar.is-success-dark .navbar-start > .navbar-item,\n .navbar.is-success-dark .navbar-start .navbar-link,\n .navbar.is-success-dark .navbar-end > .navbar-item,\n .navbar.is-success-dark .navbar-end .navbar-link {\n color: rgba(0, 0, 0, 0.7); }\n .navbar.is-success-dark .navbar-start > a.navbar-item:hover, .navbar.is-success-dark .navbar-start > a.navbar-item.is-active,\n .navbar.is-success-dark .navbar-start .navbar-link:hover,\n .navbar.is-success-dark .navbar-start .navbar-link.is-active,\n .navbar.is-success-dark .navbar-end > a.navbar-item:hover,\n .navbar.is-success-dark .navbar-end > a.navbar-item.is-active,\n .navbar.is-success-dark .navbar-end .navbar-link:hover,\n .navbar.is-success-dark .navbar-end .navbar-link.is-active {\n background-color: #14c483;\n color: rgba(0, 0, 0, 0.7); }\n .navbar.is-success-dark .navbar-start .navbar-link::after,\n .navbar.is-success-dark .navbar-end .navbar-link::after {\n border-color: rgba(0, 0, 0, 0.7); }\n .navbar.is-success-dark .navbar-item.has-dropdown:hover .navbar-link,\n .navbar.is-success-dark .navbar-item.has-dropdown.is-active .navbar-link {\n background-color: #14c483;\n color: rgba(0, 0, 0, 0.7); }\n .navbar.is-success-dark .navbar-dropdown a.navbar-item.is-active {\n background-color: #16DB93;\n color: rgba(0, 0, 0, 0.7); } }\n@media (prefers-color-scheme: dark) {\n .navbar.is-warning-dark {\n background-color: #FFE900;\n color: rgba(0, 0, 0, 0.7); }\n .navbar.is-warning-dark .navbar-brand > .navbar-item,\n .navbar.is-warning-dark .navbar-brand .navbar-link {\n color: rgba(0, 0, 0, 0.7); }\n .navbar.is-warning-dark .navbar-brand > a.navbar-item:hover, .navbar.is-warning-dark .navbar-brand > a.navbar-item.is-active,\n .navbar.is-warning-dark .navbar-brand .navbar-link:hover,\n .navbar.is-warning-dark .navbar-brand .navbar-link.is-active {\n background-color: #e6d200;\n color: rgba(0, 0, 0, 0.7); }\n .navbar.is-warning-dark .navbar-brand .navbar-link::after {\n border-color: rgba(0, 0, 0, 0.7); }\n .navbar.is-warning-dark .navbar-burger {\n color: rgba(0, 0, 0, 0.7); } }\n @media screen and (prefers-color-scheme: dark) and (min-width: 1024px) {\n .navbar.is-warning-dark .navbar-start > .navbar-item,\n .navbar.is-warning-dark .navbar-start .navbar-link,\n .navbar.is-warning-dark .navbar-end > .navbar-item,\n .navbar.is-warning-dark .navbar-end .navbar-link {\n color: rgba(0, 0, 0, 0.7); }\n .navbar.is-warning-dark .navbar-start > a.navbar-item:hover, .navbar.is-warning-dark .navbar-start > a.navbar-item.is-active,\n .navbar.is-warning-dark .navbar-start .navbar-link:hover,\n .navbar.is-warning-dark .navbar-start .navbar-link.is-active,\n .navbar.is-warning-dark .navbar-end > a.navbar-item:hover,\n .navbar.is-warning-dark .navbar-end > a.navbar-item.is-active,\n .navbar.is-warning-dark .navbar-end .navbar-link:hover,\n .navbar.is-warning-dark .navbar-end .navbar-link.is-active {\n background-color: #e6d200;\n color: rgba(0, 0, 0, 0.7); }\n .navbar.is-warning-dark .navbar-start .navbar-link::after,\n .navbar.is-warning-dark .navbar-end .navbar-link::after {\n border-color: rgba(0, 0, 0, 0.7); }\n .navbar.is-warning-dark .navbar-item.has-dropdown:hover .navbar-link,\n .navbar.is-warning-dark .navbar-item.has-dropdown.is-active .navbar-link {\n background-color: #e6d200;\n color: rgba(0, 0, 0, 0.7); }\n .navbar.is-warning-dark .navbar-dropdown a.navbar-item.is-active {\n background-color: #FFE900;\n color: rgba(0, 0, 0, 0.7); } }\n@media (prefers-color-scheme: dark) {\n .navbar.is-danger-dark {\n background-color: #f14668;\n color: #fff; }\n .navbar.is-danger-dark .navbar-brand > .navbar-item,\n .navbar.is-danger-dark .navbar-brand .navbar-link {\n color: #fff; }\n .navbar.is-danger-dark .navbar-brand > a.navbar-item:hover, .navbar.is-danger-dark .navbar-brand > a.navbar-item.is-active,\n .navbar.is-danger-dark .navbar-brand .navbar-link:hover,\n .navbar.is-danger-dark .navbar-brand .navbar-link.is-active {\n background-color: #ef2e55;\n color: #fff; }\n .navbar.is-danger-dark .navbar-brand .navbar-link::after {\n border-color: #fff; }\n .navbar.is-danger-dark .navbar-burger {\n color: #fff; } }\n @media screen and (prefers-color-scheme: dark) and (min-width: 1024px) {\n .navbar.is-danger-dark .navbar-start > .navbar-item,\n .navbar.is-danger-dark .navbar-start .navbar-link,\n .navbar.is-danger-dark .navbar-end > .navbar-item,\n .navbar.is-danger-dark .navbar-end .navbar-link {\n color: #fff; }\n .navbar.is-danger-dark .navbar-start > a.navbar-item:hover, .navbar.is-danger-dark .navbar-start > a.navbar-item.is-active,\n .navbar.is-danger-dark .navbar-start .navbar-link:hover,\n .navbar.is-danger-dark .navbar-start .navbar-link.is-active,\n .navbar.is-danger-dark .navbar-end > a.navbar-item:hover,\n .navbar.is-danger-dark .navbar-end > a.navbar-item.is-active,\n .navbar.is-danger-dark .navbar-end .navbar-link:hover,\n .navbar.is-danger-dark .navbar-end .navbar-link.is-active {\n background-color: #ef2e55;\n color: #fff; }\n .navbar.is-danger-dark .navbar-start .navbar-link::after,\n .navbar.is-danger-dark .navbar-end .navbar-link::after {\n border-color: #fff; }\n .navbar.is-danger-dark .navbar-item.has-dropdown:hover .navbar-link,\n .navbar.is-danger-dark .navbar-item.has-dropdown.is-active .navbar-link {\n background-color: #ef2e55;\n color: #fff; }\n .navbar.is-danger-dark .navbar-dropdown a.navbar-item.is-active {\n background-color: #f14668;\n color: #fff; } }\n@media (prefers-color-scheme: dark) {\n .navbar.has-shadow {\n box-shadow: 0 2px 0 0 #242424; }\n .navbar.is-fixed-bottom.has-shadow {\n box-shadow: 0 -2px 0 0 #242424; }\n .navbar-burger {\n color: #b5b5b5; }\n .navbar-item,\n .navbar-link {\n color: #b5b5b5; }\n a.navbar-item:hover, a.navbar-item.is-active,\n .navbar-link:hover,\n .navbar-link.is-active {\n background-color: #121212;\n color: #e60056; }\n .navbar-item:hover {\n border-bottom-color: #e60056; }\n .navbar-item.is-active {\n border-bottom-color: #e60056;\n color: #e60056; }\n .navbar-link:not(.is-arrowless)::after {\n border-color: #e60056; }\n .navbar-divider {\n background-color: #242424; } }\n\n@media screen and (prefers-color-scheme: dark) and (max-width: 1023px) {\n .navbar-menu {\n background-color: #17181c;\n box-shadow: 0 8px 16px rgba(255, 255, 255, 0.1); }\n .navbar.is-fixed-bottom-touch.has-shadow {\n box-shadow: 0 -2px 3px rgba(255, 255, 255, 0.1); } }\n\n@media screen and (prefers-color-scheme: dark) and (min-width: 1024px) {\n .navbar.is-transparent .navbar-dropdown a.navbar-item:hover {\n background-color: #242424;\n color: white; }\n .navbar.is-transparent .navbar-dropdown a.navbar-item.is-active {\n background-color: #242424;\n color: #e60056; }\n .navbar-item.has-dropdown-up .navbar-dropdown {\n border-bottom: 2px solid #363636;\n box-shadow: 0 -8px 8px rgba(255, 255, 255, 0.1); }\n .navbar-dropdown {\n background-color: #0a0a0a;\n border-top: 2px solid #363636;\n box-shadow: 0 8px 8px rgba(255, 255, 255, 0.1); }\n .navbar-dropdown a.navbar-item:hover {\n background-color: #242424;\n color: white; }\n .navbar-dropdown a.navbar-item.is-active {\n background-color: #242424;\n color: #e60056; }\n .navbar.is-spaced .navbar-dropdown, .navbar-dropdown.is-boxed {\n box-shadow: 0 8px 8px rgba(255, 255, 255, 0.1), 0 0 0 1px rgba(255, 255, 255, 0.1); }\n .navbar.is-fixed-bottom-desktop.has-shadow {\n box-shadow: 0 -2px 3px rgba(255, 255, 255, 0.1); }\n a.navbar-item.is-active,\n .navbar-link.is-active {\n color: white; }\n .navbar-item.has-dropdown:hover .navbar-link, .navbar-item.has-dropdown.is-active .navbar-link {\n background-color: #121212; } }\n\n@media (prefers-color-scheme: dark) {\n .pagination-previous,\n .pagination-next,\n .pagination-link {\n border-color: #363636;\n color: #dbdbdb; }\n .pagination-previous:hover,\n .pagination-next:hover,\n .pagination-link:hover {\n border-color: #4a4a4a;\n color: #dbdbdb; }\n .pagination-previous:focus,\n .pagination-next:focus,\n .pagination-link:focus {\n border-color: #5ea3e4; }\n .pagination-previous:active,\n .pagination-next:active,\n .pagination-link:active {\n box-shadow: inset 0 1px 2px rgba(255, 255, 255, 0.2); }\n .pagination-previous[disabled],\n .pagination-next[disabled],\n .pagination-link[disabled] {\n background-color: #363636;\n border-color: #363636;\n color: #7a7a7a; }\n .pagination-link.is-current {\n background-color: #e60056;\n border-color: #e60056;\n color: #fff; }\n .pagination-ellipsis {\n color: #4a4a4a; }\n .panel-heading,\n .panel-tabs,\n .panel-block {\n border-bottom: 1px solid #363636;\n border-left: 1px solid #363636;\n border-right: 1px solid #363636; }\n .panel-heading:first-child,\n .panel-tabs:first-child,\n .panel-block:first-child {\n border-top: 1px solid #363636; }\n .panel-heading {\n background-color: #242424;\n color: #dbdbdb; }\n .panel-tabs a {\n border-bottom: 1px solid #363636; }\n .panel-tabs a.is-active {\n border-bottom-color: #b5b5b5;\n color: #dbdbdb; }\n .panel-list a {\n color: #b5b5b5; }\n .panel-list a:hover {\n color: #e60056; }\n .panel-block {\n color: #dbdbdb; }\n .panel-block.is-active {\n border-left-color: #e60056;\n color: #dbdbdb; }\n .panel-block.is-active .panel-icon {\n color: #e60056; }\n a.panel-block:hover,\n label.panel-block:hover {\n background-color: #242424; }\n .tabs a {\n border-bottom-color: #363636;\n color: #b5b5b5; }\n .tabs a:hover {\n border-bottom-color: #dbdbdb;\n color: #dbdbdb; }\n .tabs li.is-active a {\n border-bottom-color: #e60056;\n color: #e60056; }\n .tabs ul {\n border-bottom-color: #363636; }\n .tabs.is-boxed a:hover {\n background-color: #242424;\n border-bottom-color: #363636; }\n .tabs.is-boxed li.is-active a {\n background-color: #0a0a0a;\n border-color: #363636; }\n .tabs.is-toggle a {\n border-color: #363636; }\n .tabs.is-toggle a:hover {\n background-color: #242424;\n border-color: #4a4a4a; }\n .tabs.is-toggle li.is-active a {\n background-color: #e60056;\n border-color: #e60056;\n color: #fff; }\n .hero.is-white, .hero.is-white-dark {\n background-color: #e6e6e6;\n color: #0a0a0a; }\n .hero.is-white a:not(.button):not(.dropdown-item):not(.tag),\n .hero.is-white strong, .hero.is-white-dark a:not(.button):not(.dropdown-item):not(.tag),\n .hero.is-white-dark strong {\n color: inherit; }\n .hero.is-white .title, .hero.is-white-dark .title {\n color: #0a0a0a; }\n .hero.is-white .subtitle, .hero.is-white-dark .subtitle {\n color: rgba(10, 10, 10, 0.9); }\n .hero.is-white .subtitle a:not(.button),\n .hero.is-white .subtitle strong, .hero.is-white-dark .subtitle a:not(.button),\n .hero.is-white-dark .subtitle strong {\n color: #0a0a0a; } }\n @media screen and (prefers-color-scheme: dark) and (max-width: 1023px) {\n .hero.is-white .navbar-menu, .hero.is-white-dark .navbar-menu {\n background-color: #e6e6e6; } }\n@media (prefers-color-scheme: dark) {\n .hero.is-white .navbar-item,\n .hero.is-white .navbar-link, .hero.is-white-dark .navbar-item,\n .hero.is-white-dark .navbar-link {\n color: rgba(10, 10, 10, 0.7); }\n .hero.is-white a.navbar-item:hover, .hero.is-white a.navbar-item.is-active,\n .hero.is-white .navbar-link:hover,\n .hero.is-white .navbar-link.is-active, .hero.is-white-dark a.navbar-item:hover, .hero.is-white-dark a.navbar-item.is-active,\n .hero.is-white-dark .navbar-link:hover,\n .hero.is-white-dark .navbar-link.is-active {\n background-color: #d9d9d9;\n color: #0a0a0a; }\n .hero.is-white .tabs a, .hero.is-white-dark .tabs a {\n color: #0a0a0a;\n opacity: 0.9; }\n .hero.is-white .tabs a:hover, .hero.is-white-dark .tabs a:hover {\n opacity: 1; }\n .hero.is-white .tabs li.is-active a, .hero.is-white-dark .tabs li.is-active a {\n opacity: 1; }\n .hero.is-white .tabs.is-boxed a, .hero.is-white .tabs.is-toggle a, .hero.is-white-dark .tabs.is-boxed a, .hero.is-white-dark .tabs.is-toggle a {\n color: #0a0a0a; }\n .hero.is-white .tabs.is-boxed a:hover, .hero.is-white .tabs.is-toggle a:hover, .hero.is-white-dark .tabs.is-boxed a:hover, .hero.is-white-dark .tabs.is-toggle a:hover {\n background-color: rgba(10, 10, 10, 0.1); }\n .hero.is-white .tabs.is-boxed li.is-active a, .hero.is-white .tabs.is-boxed li.is-active a:hover, .hero.is-white .tabs.is-toggle li.is-active a, .hero.is-white .tabs.is-toggle li.is-active a:hover, .hero.is-white-dark .tabs.is-boxed li.is-active a, .hero.is-white-dark .tabs.is-boxed li.is-active a:hover, .hero.is-white-dark .tabs.is-toggle li.is-active a, .hero.is-white-dark .tabs.is-toggle li.is-active a:hover {\n background-color: #0a0a0a;\n border-color: #0a0a0a;\n color: #e6e6e6; }\n .hero.is-white.is-bold, .hero.is-white-dark.is-bold {\n background-image: linear-gradient(141deg, #d1c7c9 0%, #e6e6e6 71%, #f3f2f2 100%); } }\n @media screen and (prefers-color-scheme: dark) and (max-width: 768px) {\n .hero.is-white.is-bold .navbar-menu, .hero.is-white-dark.is-bold .navbar-menu {\n background-image: linear-gradient(141deg, #d1c7c9 0%, #e6e6e6 71%, #f3f2f2 100%); } }\n@media (prefers-color-scheme: dark) {\n .hero.is-black, .hero.is-black-dark {\n background-color: black;\n color: white; }\n .hero.is-black a:not(.button):not(.dropdown-item):not(.tag),\n .hero.is-black strong, .hero.is-black-dark a:not(.button):not(.dropdown-item):not(.tag),\n .hero.is-black-dark strong {\n color: inherit; }\n .hero.is-black .title, .hero.is-black-dark .title {\n color: white; }\n .hero.is-black .subtitle, .hero.is-black-dark .subtitle {\n color: rgba(255, 255, 255, 0.9); }\n .hero.is-black .subtitle a:not(.button),\n .hero.is-black .subtitle strong, .hero.is-black-dark .subtitle a:not(.button),\n .hero.is-black-dark .subtitle strong {\n color: white; } }\n @media screen and (prefers-color-scheme: dark) and (max-width: 1023px) {\n .hero.is-black .navbar-menu, .hero.is-black-dark .navbar-menu {\n background-color: black; } }\n@media (prefers-color-scheme: dark) {\n .hero.is-black .navbar-item,\n .hero.is-black .navbar-link, .hero.is-black-dark .navbar-item,\n .hero.is-black-dark .navbar-link {\n color: rgba(255, 255, 255, 0.7); }\n .hero.is-black a.navbar-item:hover, .hero.is-black a.navbar-item.is-active,\n .hero.is-black .navbar-link:hover,\n .hero.is-black .navbar-link.is-active, .hero.is-black-dark a.navbar-item:hover, .hero.is-black-dark a.navbar-item.is-active,\n .hero.is-black-dark .navbar-link:hover,\n .hero.is-black-dark .navbar-link.is-active {\n background-color: black;\n color: white; }\n .hero.is-black .tabs a, .hero.is-black-dark .tabs a {\n color: white;\n opacity: 0.9; }\n .hero.is-black .tabs a:hover, .hero.is-black-dark .tabs a:hover {\n opacity: 1; }\n .hero.is-black .tabs li.is-active a, .hero.is-black-dark .tabs li.is-active a {\n opacity: 1; }\n .hero.is-black .tabs.is-boxed a, .hero.is-black .tabs.is-toggle a, .hero.is-black-dark .tabs.is-boxed a, .hero.is-black-dark .tabs.is-toggle a {\n color: white; }\n .hero.is-black .tabs.is-boxed a:hover, .hero.is-black .tabs.is-toggle a:hover, .hero.is-black-dark .tabs.is-boxed a:hover, .hero.is-black-dark .tabs.is-toggle a:hover {\n background-color: rgba(10, 10, 10, 0.1); }\n .hero.is-black .tabs.is-boxed li.is-active a, .hero.is-black .tabs.is-boxed li.is-active a:hover, .hero.is-black .tabs.is-toggle li.is-active a, .hero.is-black .tabs.is-toggle li.is-active a:hover, .hero.is-black-dark .tabs.is-boxed li.is-active a, .hero.is-black-dark .tabs.is-boxed li.is-active a:hover, .hero.is-black-dark .tabs.is-toggle li.is-active a, .hero.is-black-dark .tabs.is-toggle li.is-active a:hover {\n background-color: white;\n border-color: white;\n color: black; }\n .hero.is-black.is-bold, .hero.is-black-dark.is-bold {\n background-image: linear-gradient(141deg, black 0%, black 71%, #0d0c0c 100%); } }\n @media screen and (prefers-color-scheme: dark) and (max-width: 768px) {\n .hero.is-black.is-bold .navbar-menu, .hero.is-black-dark.is-bold .navbar-menu {\n background-image: linear-gradient(141deg, black 0%, black 71%, #0d0c0c 100%); } }\n@media (prefers-color-scheme: dark) {\n .hero.is-light, .hero.is-light-dark {\n background-color: #dbdbdb;\n color: rgba(0, 0, 0, 0.7); }\n .hero.is-light a:not(.button):not(.dropdown-item):not(.tag),\n .hero.is-light strong, .hero.is-light-dark a:not(.button):not(.dropdown-item):not(.tag),\n .hero.is-light-dark strong {\n color: inherit; }\n .hero.is-light .title, .hero.is-light-dark .title {\n color: rgba(0, 0, 0, 0.7); }\n .hero.is-light .subtitle, .hero.is-light-dark .subtitle {\n color: rgba(0, 0, 0, 0.9); }\n .hero.is-light .subtitle a:not(.button),\n .hero.is-light .subtitle strong, .hero.is-light-dark .subtitle a:not(.button),\n .hero.is-light-dark .subtitle strong {\n color: rgba(0, 0, 0, 0.7); } }\n @media screen and (prefers-color-scheme: dark) and (max-width: 1023px) {\n .hero.is-light .navbar-menu, .hero.is-light-dark .navbar-menu {\n background-color: #dbdbdb; } }\n@media (prefers-color-scheme: dark) {\n .hero.is-light .navbar-item,\n .hero.is-light .navbar-link, .hero.is-light-dark .navbar-item,\n .hero.is-light-dark .navbar-link {\n color: rgba(0, 0, 0, 0.7); }\n .hero.is-light a.navbar-item:hover, .hero.is-light a.navbar-item.is-active,\n .hero.is-light .navbar-link:hover,\n .hero.is-light .navbar-link.is-active, .hero.is-light-dark a.navbar-item:hover, .hero.is-light-dark a.navbar-item.is-active,\n .hero.is-light-dark .navbar-link:hover,\n .hero.is-light-dark .navbar-link.is-active {\n background-color: #cfcfcf;\n color: rgba(0, 0, 0, 0.7); }\n .hero.is-light .tabs a, .hero.is-light-dark .tabs a {\n color: rgba(0, 0, 0, 0.7);\n opacity: 0.9; }\n .hero.is-light .tabs a:hover, .hero.is-light-dark .tabs a:hover {\n opacity: 1; }\n .hero.is-light .tabs li.is-active a, .hero.is-light-dark .tabs li.is-active a {\n opacity: 1; }\n .hero.is-light .tabs.is-boxed a, .hero.is-light .tabs.is-toggle a, .hero.is-light-dark .tabs.is-boxed a, .hero.is-light-dark .tabs.is-toggle a {\n color: rgba(0, 0, 0, 0.7); }\n .hero.is-light .tabs.is-boxed a:hover, .hero.is-light .tabs.is-toggle a:hover, .hero.is-light-dark .tabs.is-boxed a:hover, .hero.is-light-dark .tabs.is-toggle a:hover {\n background-color: rgba(10, 10, 10, 0.1); }\n .hero.is-light .tabs.is-boxed li.is-active a, .hero.is-light .tabs.is-boxed li.is-active a:hover, .hero.is-light .tabs.is-toggle li.is-active a, .hero.is-light .tabs.is-toggle li.is-active a:hover, .hero.is-light-dark .tabs.is-boxed li.is-active a, .hero.is-light-dark .tabs.is-boxed li.is-active a:hover, .hero.is-light-dark .tabs.is-toggle li.is-active a, .hero.is-light-dark .tabs.is-toggle li.is-active a:hover {\n background-color: rgba(0, 0, 0, 0.7);\n border-color: rgba(0, 0, 0, 0.7);\n color: #dbdbdb; }\n .hero.is-light.is-bold, .hero.is-light-dark.is-bold {\n background-image: linear-gradient(141deg, #c8bcbe 0%, #dbdbdb 71%, #e9e7e7 100%); } }\n @media screen and (prefers-color-scheme: dark) and (max-width: 768px) {\n .hero.is-light.is-bold .navbar-menu, .hero.is-light-dark.is-bold .navbar-menu {\n background-image: linear-gradient(141deg, #c8bcbe 0%, #dbdbdb 71%, #e9e7e7 100%); } }\n@media (prefers-color-scheme: dark) {\n .hero.is-dark, .hero.is-dark-dark {\n background-color: #1c1c1c;\n color: #fff; }\n .hero.is-dark a:not(.button):not(.dropdown-item):not(.tag),\n .hero.is-dark strong, .hero.is-dark-dark a:not(.button):not(.dropdown-item):not(.tag),\n .hero.is-dark-dark strong {\n color: inherit; }\n .hero.is-dark .title, .hero.is-dark-dark .title {\n color: #fff; }\n .hero.is-dark .subtitle, .hero.is-dark-dark .subtitle {\n color: rgba(255, 255, 255, 0.9); }\n .hero.is-dark .subtitle a:not(.button),\n .hero.is-dark .subtitle strong, .hero.is-dark-dark .subtitle a:not(.button),\n .hero.is-dark-dark .subtitle strong {\n color: #fff; } }\n @media screen and (prefers-color-scheme: dark) and (max-width: 1023px) {\n .hero.is-dark .navbar-menu, .hero.is-dark-dark .navbar-menu {\n background-color: #1c1c1c; } }\n@media (prefers-color-scheme: dark) {\n .hero.is-dark .navbar-item,\n .hero.is-dark .navbar-link, .hero.is-dark-dark .navbar-item,\n .hero.is-dark-dark .navbar-link {\n color: rgba(255, 255, 255, 0.7); }\n .hero.is-dark a.navbar-item:hover, .hero.is-dark a.navbar-item.is-active,\n .hero.is-dark .navbar-link:hover,\n .hero.is-dark .navbar-link.is-active, .hero.is-dark-dark a.navbar-item:hover, .hero.is-dark-dark a.navbar-item.is-active,\n .hero.is-dark-dark .navbar-link:hover,\n .hero.is-dark-dark .navbar-link.is-active {\n background-color: #0f0f0f;\n color: #fff; }\n .hero.is-dark .tabs a, .hero.is-dark-dark .tabs a {\n color: #fff;\n opacity: 0.9; }\n .hero.is-dark .tabs a:hover, .hero.is-dark-dark .tabs a:hover {\n opacity: 1; }\n .hero.is-dark .tabs li.is-active a, .hero.is-dark-dark .tabs li.is-active a {\n opacity: 1; }\n .hero.is-dark .tabs.is-boxed a, .hero.is-dark .tabs.is-toggle a, .hero.is-dark-dark .tabs.is-boxed a, .hero.is-dark-dark .tabs.is-toggle a {\n color: #fff; }\n .hero.is-dark .tabs.is-boxed a:hover, .hero.is-dark .tabs.is-toggle a:hover, .hero.is-dark-dark .tabs.is-boxed a:hover, .hero.is-dark-dark .tabs.is-toggle a:hover {\n background-color: rgba(10, 10, 10, 0.1); }\n .hero.is-dark .tabs.is-boxed li.is-active a, .hero.is-dark .tabs.is-boxed li.is-active a:hover, .hero.is-dark .tabs.is-toggle li.is-active a, .hero.is-dark .tabs.is-toggle li.is-active a:hover, .hero.is-dark-dark .tabs.is-boxed li.is-active a, .hero.is-dark-dark .tabs.is-boxed li.is-active a:hover, .hero.is-dark-dark .tabs.is-toggle li.is-active a, .hero.is-dark-dark .tabs.is-toggle li.is-active a:hover {\n background-color: #fff;\n border-color: #fff;\n color: #1c1c1c; }\n .hero.is-dark.is-bold, .hero.is-dark-dark.is-bold {\n background-image: linear-gradient(141deg, #030202 0%, #1c1c1c 71%, #2b2727 100%); } }\n @media screen and (prefers-color-scheme: dark) and (max-width: 768px) {\n .hero.is-dark.is-bold .navbar-menu, .hero.is-dark-dark.is-bold .navbar-menu {\n background-image: linear-gradient(141deg, #030202 0%, #1c1c1c 71%, #2b2727 100%); } }\n@media (prefers-color-scheme: dark) {\n .hero.is-primary, .hero.is-primary-dark {\n background-color: #d90052;\n color: #fff; }\n .hero.is-primary a:not(.button):not(.dropdown-item):not(.tag),\n .hero.is-primary strong, .hero.is-primary-dark a:not(.button):not(.dropdown-item):not(.tag),\n .hero.is-primary-dark strong {\n color: inherit; }\n .hero.is-primary .title, .hero.is-primary-dark .title {\n color: #fff; }\n .hero.is-primary .subtitle, .hero.is-primary-dark .subtitle {\n color: rgba(255, 255, 255, 0.9); }\n .hero.is-primary .subtitle a:not(.button),\n .hero.is-primary .subtitle strong, .hero.is-primary-dark .subtitle a:not(.button),\n .hero.is-primary-dark .subtitle strong {\n color: #fff; } }\n @media screen and (prefers-color-scheme: dark) and (max-width: 1023px) {\n .hero.is-primary .navbar-menu, .hero.is-primary-dark .navbar-menu {\n background-color: #d90052; } }\n@media (prefers-color-scheme: dark) {\n .hero.is-primary .navbar-item,\n .hero.is-primary .navbar-link, .hero.is-primary-dark .navbar-item,\n .hero.is-primary-dark .navbar-link {\n color: rgba(255, 255, 255, 0.7); }\n .hero.is-primary a.navbar-item:hover, .hero.is-primary a.navbar-item.is-active,\n .hero.is-primary .navbar-link:hover,\n .hero.is-primary .navbar-link.is-active, .hero.is-primary-dark a.navbar-item:hover, .hero.is-primary-dark a.navbar-item.is-active,\n .hero.is-primary-dark .navbar-link:hover,\n .hero.is-primary-dark .navbar-link.is-active {\n background-color: #c00048;\n color: #fff; }\n .hero.is-primary .tabs a, .hero.is-primary-dark .tabs a {\n color: #fff;\n opacity: 0.9; }\n .hero.is-primary .tabs a:hover, .hero.is-primary-dark .tabs a:hover {\n opacity: 1; }\n .hero.is-primary .tabs li.is-active a, .hero.is-primary-dark .tabs li.is-active a {\n opacity: 1; }\n .hero.is-primary .tabs.is-boxed a, .hero.is-primary .tabs.is-toggle a, .hero.is-primary-dark .tabs.is-boxed a, .hero.is-primary-dark .tabs.is-toggle a {\n color: #fff; }\n .hero.is-primary .tabs.is-boxed a:hover, .hero.is-primary .tabs.is-toggle a:hover, .hero.is-primary-dark .tabs.is-boxed a:hover, .hero.is-primary-dark .tabs.is-toggle a:hover {\n background-color: rgba(10, 10, 10, 0.1); }\n .hero.is-primary .tabs.is-boxed li.is-active a, .hero.is-primary .tabs.is-boxed li.is-active a:hover, .hero.is-primary .tabs.is-toggle li.is-active a, .hero.is-primary .tabs.is-toggle li.is-active a:hover, .hero.is-primary-dark .tabs.is-boxed li.is-active a, .hero.is-primary-dark .tabs.is-boxed li.is-active a:hover, .hero.is-primary-dark .tabs.is-toggle li.is-active a, .hero.is-primary-dark .tabs.is-toggle li.is-active a:hover {\n background-color: #fff;\n border-color: #fff;\n color: #d90052; }\n .hero.is-primary.is-bold, .hero.is-primary-dark.is-bold {\n background-image: linear-gradient(141deg, #a6005a 0%, #d90052 71%, #f30033 100%); } }\n @media screen and (prefers-color-scheme: dark) and (max-width: 768px) {\n .hero.is-primary.is-bold .navbar-menu, .hero.is-primary-dark.is-bold .navbar-menu {\n background-image: linear-gradient(141deg, #a6005a 0%, #d90052 71%, #f30033 100%); } }\n@media (prefers-color-scheme: dark) {\n .hero.is-link, .hero.is-link-dark {\n background-color: #d90052;\n color: #fff; }\n .hero.is-link a:not(.button):not(.dropdown-item):not(.tag),\n .hero.is-link strong, .hero.is-link-dark a:not(.button):not(.dropdown-item):not(.tag),\n .hero.is-link-dark strong {\n color: inherit; }\n .hero.is-link .title, .hero.is-link-dark .title {\n color: #fff; }\n .hero.is-link .subtitle, .hero.is-link-dark .subtitle {\n color: rgba(255, 255, 255, 0.9); }\n .hero.is-link .subtitle a:not(.button),\n .hero.is-link .subtitle strong, .hero.is-link-dark .subtitle a:not(.button),\n .hero.is-link-dark .subtitle strong {\n color: #fff; } }\n @media screen and (prefers-color-scheme: dark) and (max-width: 1023px) {\n .hero.is-link .navbar-menu, .hero.is-link-dark .navbar-menu {\n background-color: #d90052; } }\n@media (prefers-color-scheme: dark) {\n .hero.is-link .navbar-item,\n .hero.is-link .navbar-link, .hero.is-link-dark .navbar-item,\n .hero.is-link-dark .navbar-link {\n color: rgba(255, 255, 255, 0.7); }\n .hero.is-link a.navbar-item:hover, .hero.is-link a.navbar-item.is-active,\n .hero.is-link .navbar-link:hover,\n .hero.is-link .navbar-link.is-active, .hero.is-link-dark a.navbar-item:hover, .hero.is-link-dark a.navbar-item.is-active,\n .hero.is-link-dark .navbar-link:hover,\n .hero.is-link-dark .navbar-link.is-active {\n background-color: #c00048;\n color: #fff; }\n .hero.is-link .tabs a, .hero.is-link-dark .tabs a {\n color: #fff;\n opacity: 0.9; }\n .hero.is-link .tabs a:hover, .hero.is-link-dark .tabs a:hover {\n opacity: 1; }\n .hero.is-link .tabs li.is-active a, .hero.is-link-dark .tabs li.is-active a {\n opacity: 1; }\n .hero.is-link .tabs.is-boxed a, .hero.is-link .tabs.is-toggle a, .hero.is-link-dark .tabs.is-boxed a, .hero.is-link-dark .tabs.is-toggle a {\n color: #fff; }\n .hero.is-link .tabs.is-boxed a:hover, .hero.is-link .tabs.is-toggle a:hover, .hero.is-link-dark .tabs.is-boxed a:hover, .hero.is-link-dark .tabs.is-toggle a:hover {\n background-color: rgba(10, 10, 10, 0.1); }\n .hero.is-link .tabs.is-boxed li.is-active a, .hero.is-link .tabs.is-boxed li.is-active a:hover, .hero.is-link .tabs.is-toggle li.is-active a, .hero.is-link .tabs.is-toggle li.is-active a:hover, .hero.is-link-dark .tabs.is-boxed li.is-active a, .hero.is-link-dark .tabs.is-boxed li.is-active a:hover, .hero.is-link-dark .tabs.is-toggle li.is-active a, .hero.is-link-dark .tabs.is-toggle li.is-active a:hover {\n background-color: #fff;\n border-color: #fff;\n color: #d90052; }\n .hero.is-link.is-bold, .hero.is-link-dark.is-bold {\n background-image: linear-gradient(141deg, #a6005a 0%, #d90052 71%, #f30033 100%); } }\n @media screen and (prefers-color-scheme: dark) and (max-width: 768px) {\n .hero.is-link.is-bold .navbar-menu, .hero.is-link-dark.is-bold .navbar-menu {\n background-image: linear-gradient(141deg, #a6005a 0%, #d90052 71%, #f30033 100%); } }\n@media (prefers-color-scheme: dark) {\n .hero.is-info, .hero.is-info-dark {\n background-color: #0075cc;\n color: #fff; }\n .hero.is-info a:not(.button):not(.dropdown-item):not(.tag),\n .hero.is-info strong, .hero.is-info-dark a:not(.button):not(.dropdown-item):not(.tag),\n .hero.is-info-dark strong {\n color: inherit; }\n .hero.is-info .title, .hero.is-info-dark .title {\n color: #fff; }\n .hero.is-info .subtitle, .hero.is-info-dark .subtitle {\n color: rgba(255, 255, 255, 0.9); }\n .hero.is-info .subtitle a:not(.button),\n .hero.is-info .subtitle strong, .hero.is-info-dark .subtitle a:not(.button),\n .hero.is-info-dark .subtitle strong {\n color: #fff; } }\n @media screen and (prefers-color-scheme: dark) and (max-width: 1023px) {\n .hero.is-info .navbar-menu, .hero.is-info-dark .navbar-menu {\n background-color: #0075cc; } }\n@media (prefers-color-scheme: dark) {\n .hero.is-info .navbar-item,\n .hero.is-info .navbar-link, .hero.is-info-dark .navbar-item,\n .hero.is-info-dark .navbar-link {\n color: rgba(255, 255, 255, 0.7); }\n .hero.is-info a.navbar-item:hover, .hero.is-info a.navbar-item.is-active,\n .hero.is-info .navbar-link:hover,\n .hero.is-info .navbar-link.is-active, .hero.is-info-dark a.navbar-item:hover, .hero.is-info-dark a.navbar-item.is-active,\n .hero.is-info-dark .navbar-link:hover,\n .hero.is-info-dark .navbar-link.is-active {\n background-color: #0066b3;\n color: #fff; }\n .hero.is-info .tabs a, .hero.is-info-dark .tabs a {\n color: #fff;\n opacity: 0.9; }\n .hero.is-info .tabs a:hover, .hero.is-info-dark .tabs a:hover {\n opacity: 1; }\n .hero.is-info .tabs li.is-active a, .hero.is-info-dark .tabs li.is-active a {\n opacity: 1; }\n .hero.is-info .tabs.is-boxed a, .hero.is-info .tabs.is-toggle a, .hero.is-info-dark .tabs.is-boxed a, .hero.is-info-dark .tabs.is-toggle a {\n color: #fff; }\n .hero.is-info .tabs.is-boxed a:hover, .hero.is-info .tabs.is-toggle a:hover, .hero.is-info-dark .tabs.is-boxed a:hover, .hero.is-info-dark .tabs.is-toggle a:hover {\n background-color: rgba(10, 10, 10, 0.1); }\n .hero.is-info .tabs.is-boxed li.is-active a, .hero.is-info .tabs.is-boxed li.is-active a:hover, .hero.is-info .tabs.is-toggle li.is-active a, .hero.is-info .tabs.is-toggle li.is-active a:hover, .hero.is-info-dark .tabs.is-boxed li.is-active a, .hero.is-info-dark .tabs.is-boxed li.is-active a:hover, .hero.is-info-dark .tabs.is-toggle li.is-active a, .hero.is-info-dark .tabs.is-toggle li.is-active a:hover {\n background-color: #fff;\n border-color: #fff;\n color: #0075cc; }\n .hero.is-info.is-bold, .hero.is-info-dark.is-bold {\n background-image: linear-gradient(141deg, #007199 0%, #0075cc 71%, #005de6 100%); } }\n @media screen and (prefers-color-scheme: dark) and (max-width: 768px) {\n .hero.is-info.is-bold .navbar-menu, .hero.is-info-dark.is-bold .navbar-menu {\n background-image: linear-gradient(141deg, #007199 0%, #0075cc 71%, #005de6 100%); } }\n@media (prefers-color-scheme: dark) {\n .hero.is-success, .hero.is-success-dark {\n background-color: #11ad74;\n color: rgba(0, 0, 0, 0.7); }\n .hero.is-success a:not(.button):not(.dropdown-item):not(.tag),\n .hero.is-success strong, .hero.is-success-dark a:not(.button):not(.dropdown-item):not(.tag),\n .hero.is-success-dark strong {\n color: inherit; }\n .hero.is-success .title, .hero.is-success-dark .title {\n color: rgba(0, 0, 0, 0.7); }\n .hero.is-success .subtitle, .hero.is-success-dark .subtitle {\n color: rgba(0, 0, 0, 0.9); }\n .hero.is-success .subtitle a:not(.button),\n .hero.is-success .subtitle strong, .hero.is-success-dark .subtitle a:not(.button),\n .hero.is-success-dark .subtitle strong {\n color: rgba(0, 0, 0, 0.7); } }\n @media screen and (prefers-color-scheme: dark) and (max-width: 1023px) {\n .hero.is-success .navbar-menu, .hero.is-success-dark .navbar-menu {\n background-color: #11ad74; } }\n@media (prefers-color-scheme: dark) {\n .hero.is-success .navbar-item,\n .hero.is-success .navbar-link, .hero.is-success-dark .navbar-item,\n .hero.is-success-dark .navbar-link {\n color: rgba(0, 0, 0, 0.7); }\n .hero.is-success a.navbar-item:hover, .hero.is-success a.navbar-item.is-active,\n .hero.is-success .navbar-link:hover,\n .hero.is-success .navbar-link.is-active, .hero.is-success-dark a.navbar-item:hover, .hero.is-success-dark a.navbar-item.is-active,\n .hero.is-success-dark .navbar-link:hover,\n .hero.is-success-dark .navbar-link.is-active {\n background-color: #0f9564;\n color: rgba(0, 0, 0, 0.7); }\n .hero.is-success .tabs a, .hero.is-success-dark .tabs a {\n color: rgba(0, 0, 0, 0.7);\n opacity: 0.9; }\n .hero.is-success .tabs a:hover, .hero.is-success-dark .tabs a:hover {\n opacity: 1; }\n .hero.is-success .tabs li.is-active a, .hero.is-success-dark .tabs li.is-active a {\n opacity: 1; }\n .hero.is-success .tabs.is-boxed a, .hero.is-success .tabs.is-toggle a, .hero.is-success-dark .tabs.is-boxed a, .hero.is-success-dark .tabs.is-toggle a {\n color: rgba(0, 0, 0, 0.7); }\n .hero.is-success .tabs.is-boxed a:hover, .hero.is-success .tabs.is-toggle a:hover, .hero.is-success-dark .tabs.is-boxed a:hover, .hero.is-success-dark .tabs.is-toggle a:hover {\n background-color: rgba(10, 10, 10, 0.1); }\n .hero.is-success .tabs.is-boxed li.is-active a, .hero.is-success .tabs.is-boxed li.is-active a:hover, .hero.is-success .tabs.is-toggle li.is-active a, .hero.is-success .tabs.is-toggle li.is-active a:hover, .hero.is-success-dark .tabs.is-boxed li.is-active a, .hero.is-success-dark .tabs.is-boxed li.is-active a:hover, .hero.is-success-dark .tabs.is-toggle li.is-active a, .hero.is-success-dark .tabs.is-toggle li.is-active a:hover {\n background-color: rgba(0, 0, 0, 0.7);\n border-color: rgba(0, 0, 0, 0.7);\n color: #11ad74; }\n .hero.is-success.is-bold, .hero.is-success-dark.is-bold {\n background-image: linear-gradient(141deg, #068541 0%, #11ad74 71%, #0ec9a4 100%); } }\n @media screen and (prefers-color-scheme: dark) and (max-width: 768px) {\n .hero.is-success.is-bold .navbar-menu, .hero.is-success-dark.is-bold .navbar-menu {\n background-image: linear-gradient(141deg, #068541 0%, #11ad74 71%, #0ec9a4 100%); } }\n@media (prefers-color-scheme: dark) {\n .hero.is-warning, .hero.is-warning-dark {\n background-color: #ccba00;\n color: rgba(0, 0, 0, 0.7); }\n .hero.is-warning a:not(.button):not(.dropdown-item):not(.tag),\n .hero.is-warning strong, .hero.is-warning-dark a:not(.button):not(.dropdown-item):not(.tag),\n .hero.is-warning-dark strong {\n color: inherit; }\n .hero.is-warning .title, .hero.is-warning-dark .title {\n color: rgba(0, 0, 0, 0.7); }\n .hero.is-warning .subtitle, .hero.is-warning-dark .subtitle {\n color: rgba(0, 0, 0, 0.9); }\n .hero.is-warning .subtitle a:not(.button),\n .hero.is-warning .subtitle strong, .hero.is-warning-dark .subtitle a:not(.button),\n .hero.is-warning-dark .subtitle strong {\n color: rgba(0, 0, 0, 0.7); } }\n @media screen and (prefers-color-scheme: dark) and (max-width: 1023px) {\n .hero.is-warning .navbar-menu, .hero.is-warning-dark .navbar-menu {\n background-color: #ccba00; } }\n@media (prefers-color-scheme: dark) {\n .hero.is-warning .navbar-item,\n .hero.is-warning .navbar-link, .hero.is-warning-dark .navbar-item,\n .hero.is-warning-dark .navbar-link {\n color: rgba(0, 0, 0, 0.7); }\n .hero.is-warning a.navbar-item:hover, .hero.is-warning a.navbar-item.is-active,\n .hero.is-warning .navbar-link:hover,\n .hero.is-warning .navbar-link.is-active, .hero.is-warning-dark a.navbar-item:hover, .hero.is-warning-dark a.navbar-item.is-active,\n .hero.is-warning-dark .navbar-link:hover,\n .hero.is-warning-dark .navbar-link.is-active {\n background-color: #b3a300;\n color: rgba(0, 0, 0, 0.7); }\n .hero.is-warning .tabs a, .hero.is-warning-dark .tabs a {\n color: rgba(0, 0, 0, 0.7);\n opacity: 0.9; }\n .hero.is-warning .tabs a:hover, .hero.is-warning-dark .tabs a:hover {\n opacity: 1; }\n .hero.is-warning .tabs li.is-active a, .hero.is-warning-dark .tabs li.is-active a {\n opacity: 1; }\n .hero.is-warning .tabs.is-boxed a, .hero.is-warning .tabs.is-toggle a, .hero.is-warning-dark .tabs.is-boxed a, .hero.is-warning-dark .tabs.is-toggle a {\n color: rgba(0, 0, 0, 0.7); }\n .hero.is-warning .tabs.is-boxed a:hover, .hero.is-warning .tabs.is-toggle a:hover, .hero.is-warning-dark .tabs.is-boxed a:hover, .hero.is-warning-dark .tabs.is-toggle a:hover {\n background-color: rgba(10, 10, 10, 0.1); }\n .hero.is-warning .tabs.is-boxed li.is-active a, .hero.is-warning .tabs.is-boxed li.is-active a:hover, .hero.is-warning .tabs.is-toggle li.is-active a, .hero.is-warning .tabs.is-toggle li.is-active a:hover, .hero.is-warning-dark .tabs.is-boxed li.is-active a, .hero.is-warning-dark .tabs.is-boxed li.is-active a:hover, .hero.is-warning-dark .tabs.is-toggle li.is-active a, .hero.is-warning-dark .tabs.is-toggle li.is-active a:hover {\n background-color: rgba(0, 0, 0, 0.7);\n border-color: rgba(0, 0, 0, 0.7);\n color: #ccba00; }\n .hero.is-warning.is-bold, .hero.is-warning-dark.is-bold {\n background-image: linear-gradient(141deg, #997200 0%, #ccba00 71%, #d3e600 100%); } }\n @media screen and (prefers-color-scheme: dark) and (max-width: 768px) {\n .hero.is-warning.is-bold .navbar-menu, .hero.is-warning-dark.is-bold .navbar-menu {\n background-image: linear-gradient(141deg, #997200 0%, #ccba00 71%, #d3e600 100%); } }\n@media (prefers-color-scheme: dark) {\n .hero.is-danger, .hero.is-danger-dark {\n background-color: #ee1742;\n color: #fff; }\n .hero.is-danger a:not(.button):not(.dropdown-item):not(.tag),\n .hero.is-danger strong, .hero.is-danger-dark a:not(.button):not(.dropdown-item):not(.tag),\n .hero.is-danger-dark strong {\n color: inherit; }\n .hero.is-danger .title, .hero.is-danger-dark .title {\n color: #fff; }\n .hero.is-danger .subtitle, .hero.is-danger-dark .subtitle {\n color: rgba(255, 255, 255, 0.9); }\n .hero.is-danger .subtitle a:not(.button),\n .hero.is-danger .subtitle strong, .hero.is-danger-dark .subtitle a:not(.button),\n .hero.is-danger-dark .subtitle strong {\n color: #fff; } }\n @media screen and (prefers-color-scheme: dark) and (max-width: 1023px) {\n .hero.is-danger .navbar-menu, .hero.is-danger-dark .navbar-menu {\n background-color: #ee1742; } }\n@media (prefers-color-scheme: dark) {\n .hero.is-danger .navbar-item,\n .hero.is-danger .navbar-link, .hero.is-danger-dark .navbar-item,\n .hero.is-danger-dark .navbar-link {\n color: rgba(255, 255, 255, 0.7); }\n .hero.is-danger a.navbar-item:hover, .hero.is-danger a.navbar-item.is-active,\n .hero.is-danger .navbar-link:hover,\n .hero.is-danger .navbar-link.is-active, .hero.is-danger-dark a.navbar-item:hover, .hero.is-danger-dark a.navbar-item.is-active,\n .hero.is-danger-dark .navbar-link:hover,\n .hero.is-danger-dark .navbar-link.is-active {\n background-color: #da1039;\n color: #fff; }\n .hero.is-danger .tabs a, .hero.is-danger-dark .tabs a {\n color: #fff;\n opacity: 0.9; }\n .hero.is-danger .tabs a:hover, .hero.is-danger-dark .tabs a:hover {\n opacity: 1; }\n .hero.is-danger .tabs li.is-active a, .hero.is-danger-dark .tabs li.is-active a {\n opacity: 1; }\n .hero.is-danger .tabs.is-boxed a, .hero.is-danger .tabs.is-toggle a, .hero.is-danger-dark .tabs.is-boxed a, .hero.is-danger-dark .tabs.is-toggle a {\n color: #fff; }\n .hero.is-danger .tabs.is-boxed a:hover, .hero.is-danger .tabs.is-toggle a:hover, .hero.is-danger-dark .tabs.is-boxed a:hover, .hero.is-danger-dark .tabs.is-toggle a:hover {\n background-color: rgba(10, 10, 10, 0.1); }\n .hero.is-danger .tabs.is-boxed li.is-active a, .hero.is-danger .tabs.is-boxed li.is-active a:hover, .hero.is-danger .tabs.is-toggle li.is-active a, .hero.is-danger .tabs.is-toggle li.is-active a:hover, .hero.is-danger-dark .tabs.is-boxed li.is-active a, .hero.is-danger-dark .tabs.is-boxed li.is-active a:hover, .hero.is-danger-dark .tabs.is-toggle li.is-active a, .hero.is-danger-dark .tabs.is-toggle li.is-active a:hover {\n background-color: #fff;\n border-color: #fff;\n color: #ee1742; }\n .hero.is-danger.is-bold, .hero.is-danger-dark.is-bold {\n background-image: linear-gradient(141deg, #cd044e 0%, #ee1742 71%, #f52930 100%); } }\n @media screen and (prefers-color-scheme: dark) and (max-width: 768px) {\n .hero.is-danger.is-bold .navbar-menu, .hero.is-danger-dark.is-bold .navbar-menu {\n background-image: linear-gradient(141deg, #cd044e 0%, #ee1742 71%, #f52930 100%); } }\n@media (prefers-color-scheme: dark) {\n .hero.is-white-dark {\n background-color: white;\n color: #0a0a0a; }\n .hero.is-white-dark a:not(.button):not(.dropdown-item):not(.tag),\n .hero.is-white-dark strong {\n color: inherit; }\n .hero.is-white-dark .title {\n color: #0a0a0a; }\n .hero.is-white-dark .subtitle {\n color: rgba(10, 10, 10, 0.9); }\n .hero.is-white-dark .subtitle a:not(.button),\n .hero.is-white-dark .subtitle strong {\n color: #0a0a0a; } }\n @media screen and (prefers-color-scheme: dark) and (max-width: 1023px) {\n .hero.is-white-dark .navbar-menu {\n background-color: white; } }\n@media (prefers-color-scheme: dark) {\n .hero.is-white-dark .navbar-item,\n .hero.is-white-dark .navbar-link {\n color: rgba(10, 10, 10, 0.7); }\n .hero.is-white-dark a.navbar-item:hover, .hero.is-white-dark a.navbar-item.is-active,\n .hero.is-white-dark .navbar-link:hover,\n .hero.is-white-dark .navbar-link.is-active {\n background-color: #f2f2f2;\n color: #0a0a0a; }\n .hero.is-white-dark .tabs a {\n color: #0a0a0a;\n opacity: 0.9; }\n .hero.is-white-dark .tabs a:hover {\n opacity: 1; }\n .hero.is-white-dark .tabs li.is-active a {\n opacity: 1; }\n .hero.is-white-dark .tabs.is-boxed a, .hero.is-white-dark .tabs.is-toggle a {\n color: #0a0a0a; }\n .hero.is-white-dark .tabs.is-boxed a:hover, .hero.is-white-dark .tabs.is-toggle a:hover {\n background-color: rgba(10, 10, 10, 0.1); }\n .hero.is-white-dark .tabs.is-boxed li.is-active a, .hero.is-white-dark .tabs.is-boxed li.is-active a:hover, .hero.is-white-dark .tabs.is-toggle li.is-active a, .hero.is-white-dark .tabs.is-toggle li.is-active a:hover {\n background-color: #0a0a0a;\n border-color: #0a0a0a;\n color: white; }\n .hero.is-white-dark.is-bold {\n background-image: linear-gradient(141deg, #e8e3e4 0%, white 71%, white 100%); } }\n @media screen and (prefers-color-scheme: dark) and (max-width: 768px) {\n .hero.is-white-dark.is-bold .navbar-menu {\n background-image: linear-gradient(141deg, #e8e3e4 0%, white 71%, white 100%); } }\n@media (prefers-color-scheme: dark) {\n .hero.is-black-dark {\n background-color: #0a0a0a;\n color: white; }\n .hero.is-black-dark a:not(.button):not(.dropdown-item):not(.tag),\n .hero.is-black-dark strong {\n color: inherit; }\n .hero.is-black-dark .title {\n color: white; }\n .hero.is-black-dark .subtitle {\n color: rgba(255, 255, 255, 0.9); }\n .hero.is-black-dark .subtitle a:not(.button),\n .hero.is-black-dark .subtitle strong {\n color: white; } }\n @media screen and (prefers-color-scheme: dark) and (max-width: 1023px) {\n .hero.is-black-dark .navbar-menu {\n background-color: #0a0a0a; } }\n@media (prefers-color-scheme: dark) {\n .hero.is-black-dark .navbar-item,\n .hero.is-black-dark .navbar-link {\n color: rgba(255, 255, 255, 0.7); }\n .hero.is-black-dark a.navbar-item:hover, .hero.is-black-dark a.navbar-item.is-active,\n .hero.is-black-dark .navbar-link:hover,\n .hero.is-black-dark .navbar-link.is-active {\n background-color: black;\n color: white; }\n .hero.is-black-dark .tabs a {\n color: white;\n opacity: 0.9; }\n .hero.is-black-dark .tabs a:hover {\n opacity: 1; }\n .hero.is-black-dark .tabs li.is-active a {\n opacity: 1; }\n .hero.is-black-dark .tabs.is-boxed a, .hero.is-black-dark .tabs.is-toggle a {\n color: white; }\n .hero.is-black-dark .tabs.is-boxed a:hover, .hero.is-black-dark .tabs.is-toggle a:hover {\n background-color: rgba(10, 10, 10, 0.1); }\n .hero.is-black-dark .tabs.is-boxed li.is-active a, .hero.is-black-dark .tabs.is-boxed li.is-active a:hover, .hero.is-black-dark .tabs.is-toggle li.is-active a, .hero.is-black-dark .tabs.is-toggle li.is-active a:hover {\n background-color: white;\n border-color: white;\n color: #0a0a0a; }\n .hero.is-black-dark.is-bold {\n background-image: linear-gradient(141deg, black 0%, #0a0a0a 71%, #181616 100%); } }\n @media screen and (prefers-color-scheme: dark) and (max-width: 768px) {\n .hero.is-black-dark.is-bold .navbar-menu {\n background-image: linear-gradient(141deg, black 0%, #0a0a0a 71%, #181616 100%); } }\n@media (prefers-color-scheme: dark) {\n .hero.is-light-dark {\n background-color: whitesmoke;\n color: rgba(0, 0, 0, 0.7); }\n .hero.is-light-dark a:not(.button):not(.dropdown-item):not(.tag),\n .hero.is-light-dark strong {\n color: inherit; }\n .hero.is-light-dark .title {\n color: rgba(0, 0, 0, 0.7); }\n .hero.is-light-dark .subtitle {\n color: rgba(0, 0, 0, 0.9); }\n .hero.is-light-dark .subtitle a:not(.button),\n .hero.is-light-dark .subtitle strong {\n color: rgba(0, 0, 0, 0.7); } }\n @media screen and (prefers-color-scheme: dark) and (max-width: 1023px) {\n .hero.is-light-dark .navbar-menu {\n background-color: whitesmoke; } }\n@media (prefers-color-scheme: dark) {\n .hero.is-light-dark .navbar-item,\n .hero.is-light-dark .navbar-link {\n color: rgba(0, 0, 0, 0.7); }\n .hero.is-light-dark a.navbar-item:hover, .hero.is-light-dark a.navbar-item.is-active,\n .hero.is-light-dark .navbar-link:hover,\n .hero.is-light-dark .navbar-link.is-active {\n background-color: #e8e8e8;\n color: rgba(0, 0, 0, 0.7); }\n .hero.is-light-dark .tabs a {\n color: rgba(0, 0, 0, 0.7);\n opacity: 0.9; }\n .hero.is-light-dark .tabs a:hover {\n opacity: 1; }\n .hero.is-light-dark .tabs li.is-active a {\n opacity: 1; }\n .hero.is-light-dark .tabs.is-boxed a, .hero.is-light-dark .tabs.is-toggle a {\n color: rgba(0, 0, 0, 0.7); }\n .hero.is-light-dark .tabs.is-boxed a:hover, .hero.is-light-dark .tabs.is-toggle a:hover {\n background-color: rgba(10, 10, 10, 0.1); }\n .hero.is-light-dark .tabs.is-boxed li.is-active a, .hero.is-light-dark .tabs.is-boxed li.is-active a:hover, .hero.is-light-dark .tabs.is-toggle li.is-active a, .hero.is-light-dark .tabs.is-toggle li.is-active a:hover {\n background-color: rgba(0, 0, 0, 0.7);\n border-color: rgba(0, 0, 0, 0.7);\n color: whitesmoke; }\n .hero.is-light-dark.is-bold {\n background-image: linear-gradient(141deg, #dfd8d9 0%, whitesmoke 71%, white 100%); } }\n @media screen and (prefers-color-scheme: dark) and (max-width: 768px) {\n .hero.is-light-dark.is-bold .navbar-menu {\n background-image: linear-gradient(141deg, #dfd8d9 0%, whitesmoke 71%, white 100%); } }\n@media (prefers-color-scheme: dark) {\n .hero.is-dark-dark {\n background-color: #363636;\n color: #fff; }\n .hero.is-dark-dark a:not(.button):not(.dropdown-item):not(.tag),\n .hero.is-dark-dark strong {\n color: inherit; }\n .hero.is-dark-dark .title {\n color: #fff; }\n .hero.is-dark-dark .subtitle {\n color: rgba(255, 255, 255, 0.9); }\n .hero.is-dark-dark .subtitle a:not(.button),\n .hero.is-dark-dark .subtitle strong {\n color: #fff; } }\n @media screen and (prefers-color-scheme: dark) and (max-width: 1023px) {\n .hero.is-dark-dark .navbar-menu {\n background-color: #363636; } }\n@media (prefers-color-scheme: dark) {\n .hero.is-dark-dark .navbar-item,\n .hero.is-dark-dark .navbar-link {\n color: rgba(255, 255, 255, 0.7); }\n .hero.is-dark-dark a.navbar-item:hover, .hero.is-dark-dark a.navbar-item.is-active,\n .hero.is-dark-dark .navbar-link:hover,\n .hero.is-dark-dark .navbar-link.is-active {\n background-color: #292929;\n color: #fff; }\n .hero.is-dark-dark .tabs a {\n color: #fff;\n opacity: 0.9; }\n .hero.is-dark-dark .tabs a:hover {\n opacity: 1; }\n .hero.is-dark-dark .tabs li.is-active a {\n opacity: 1; }\n .hero.is-dark-dark .tabs.is-boxed a, .hero.is-dark-dark .tabs.is-toggle a {\n color: #fff; }\n .hero.is-dark-dark .tabs.is-boxed a:hover, .hero.is-dark-dark .tabs.is-toggle a:hover {\n background-color: rgba(10, 10, 10, 0.1); }\n .hero.is-dark-dark .tabs.is-boxed li.is-active a, .hero.is-dark-dark .tabs.is-boxed li.is-active a:hover, .hero.is-dark-dark .tabs.is-toggle li.is-active a, .hero.is-dark-dark .tabs.is-toggle li.is-active a:hover {\n background-color: #fff;\n border-color: #fff;\n color: #363636; }\n .hero.is-dark-dark.is-bold {\n background-image: linear-gradient(141deg, #1f191a 0%, #363636 71%, #46403f 100%); } }\n @media screen and (prefers-color-scheme: dark) and (max-width: 768px) {\n .hero.is-dark-dark.is-bold .navbar-menu {\n background-image: linear-gradient(141deg, #1f191a 0%, #363636 71%, #46403f 100%); } }\n@media (prefers-color-scheme: dark) {\n .hero.is-primary-dark {\n background-color: #ff0d68;\n color: #fff; }\n .hero.is-primary-dark a:not(.button):not(.dropdown-item):not(.tag),\n .hero.is-primary-dark strong {\n color: inherit; }\n .hero.is-primary-dark .title {\n color: #fff; }\n .hero.is-primary-dark .subtitle {\n color: rgba(255, 255, 255, 0.9); }\n .hero.is-primary-dark .subtitle a:not(.button),\n .hero.is-primary-dark .subtitle strong {\n color: #fff; } }\n @media screen and (prefers-color-scheme: dark) and (max-width: 1023px) {\n .hero.is-primary-dark .navbar-menu {\n background-color: #ff0d68; } }\n@media (prefers-color-scheme: dark) {\n .hero.is-primary-dark .navbar-item,\n .hero.is-primary-dark .navbar-link {\n color: rgba(255, 255, 255, 0.7); }\n .hero.is-primary-dark a.navbar-item:hover, .hero.is-primary-dark a.navbar-item.is-active,\n .hero.is-primary-dark .navbar-link:hover,\n .hero.is-primary-dark .navbar-link.is-active {\n background-color: #f3005b;\n color: #fff; }\n .hero.is-primary-dark .tabs a {\n color: #fff;\n opacity: 0.9; }\n .hero.is-primary-dark .tabs a:hover {\n opacity: 1; }\n .hero.is-primary-dark .tabs li.is-active a {\n opacity: 1; }\n .hero.is-primary-dark .tabs.is-boxed a, .hero.is-primary-dark .tabs.is-toggle a {\n color: #fff; }\n .hero.is-primary-dark .tabs.is-boxed a:hover, .hero.is-primary-dark .tabs.is-toggle a:hover {\n background-color: rgba(10, 10, 10, 0.1); }\n .hero.is-primary-dark .tabs.is-boxed li.is-active a, .hero.is-primary-dark .tabs.is-boxed li.is-active a:hover, .hero.is-primary-dark .tabs.is-toggle li.is-active a, .hero.is-primary-dark .tabs.is-toggle li.is-active a:hover {\n background-color: #fff;\n border-color: #fff;\n color: #ff0d68; }\n .hero.is-primary-dark.is-bold {\n background-image: linear-gradient(141deg, #d90076 0%, #ff0d68 71%, #ff2754 100%); } }\n @media screen and (prefers-color-scheme: dark) and (max-width: 768px) {\n .hero.is-primary-dark.is-bold .navbar-menu {\n background-image: linear-gradient(141deg, #d90076 0%, #ff0d68 71%, #ff2754 100%); } }\n@media (prefers-color-scheme: dark) {\n .hero.is-link-dark {\n background-color: #ff0d68;\n color: #fff; }\n .hero.is-link-dark a:not(.button):not(.dropdown-item):not(.tag),\n .hero.is-link-dark strong {\n color: inherit; }\n .hero.is-link-dark .title {\n color: #fff; }\n .hero.is-link-dark .subtitle {\n color: rgba(255, 255, 255, 0.9); }\n .hero.is-link-dark .subtitle a:not(.button),\n .hero.is-link-dark .subtitle strong {\n color: #fff; } }\n @media screen and (prefers-color-scheme: dark) and (max-width: 1023px) {\n .hero.is-link-dark .navbar-menu {\n background-color: #ff0d68; } }\n@media (prefers-color-scheme: dark) {\n .hero.is-link-dark .navbar-item,\n .hero.is-link-dark .navbar-link {\n color: rgba(255, 255, 255, 0.7); }\n .hero.is-link-dark a.navbar-item:hover, .hero.is-link-dark a.navbar-item.is-active,\n .hero.is-link-dark .navbar-link:hover,\n .hero.is-link-dark .navbar-link.is-active {\n background-color: #f3005b;\n color: #fff; }\n .hero.is-link-dark .tabs a {\n color: #fff;\n opacity: 0.9; }\n .hero.is-link-dark .tabs a:hover {\n opacity: 1; }\n .hero.is-link-dark .tabs li.is-active a {\n opacity: 1; }\n .hero.is-link-dark .tabs.is-boxed a, .hero.is-link-dark .tabs.is-toggle a {\n color: #fff; }\n .hero.is-link-dark .tabs.is-boxed a:hover, .hero.is-link-dark .tabs.is-toggle a:hover {\n background-color: rgba(10, 10, 10, 0.1); }\n .hero.is-link-dark .tabs.is-boxed li.is-active a, .hero.is-link-dark .tabs.is-boxed li.is-active a:hover, .hero.is-link-dark .tabs.is-toggle li.is-active a, .hero.is-link-dark .tabs.is-toggle li.is-active a:hover {\n background-color: #fff;\n border-color: #fff;\n color: #ff0d68; }\n .hero.is-link-dark.is-bold {\n background-image: linear-gradient(141deg, #d90076 0%, #ff0d68 71%, #ff2754 100%); } }\n @media screen and (prefers-color-scheme: dark) and (max-width: 768px) {\n .hero.is-link-dark.is-bold .navbar-menu {\n background-image: linear-gradient(141deg, #d90076 0%, #ff0d68 71%, #ff2754 100%); } }\n@media (prefers-color-scheme: dark) {\n .hero.is-info-dark {\n background-color: #0092FF;\n color: #fff; }\n .hero.is-info-dark a:not(.button):not(.dropdown-item):not(.tag),\n .hero.is-info-dark strong {\n color: inherit; }\n .hero.is-info-dark .title {\n color: #fff; }\n .hero.is-info-dark .subtitle {\n color: rgba(255, 255, 255, 0.9); }\n .hero.is-info-dark .subtitle a:not(.button),\n .hero.is-info-dark .subtitle strong {\n color: #fff; } }\n @media screen and (prefers-color-scheme: dark) and (max-width: 1023px) {\n .hero.is-info-dark .navbar-menu {\n background-color: #0092FF; } }\n@media (prefers-color-scheme: dark) {\n .hero.is-info-dark .navbar-item,\n .hero.is-info-dark .navbar-link {\n color: rgba(255, 255, 255, 0.7); }\n .hero.is-info-dark a.navbar-item:hover, .hero.is-info-dark a.navbar-item.is-active,\n .hero.is-info-dark .navbar-link:hover,\n .hero.is-info-dark .navbar-link.is-active {\n background-color: #0083e6;\n color: #fff; }\n .hero.is-info-dark .tabs a {\n color: #fff;\n opacity: 0.9; }\n .hero.is-info-dark .tabs a:hover {\n opacity: 1; }\n .hero.is-info-dark .tabs li.is-active a {\n opacity: 1; }\n .hero.is-info-dark .tabs.is-boxed a, .hero.is-info-dark .tabs.is-toggle a {\n color: #fff; }\n .hero.is-info-dark .tabs.is-boxed a:hover, .hero.is-info-dark .tabs.is-toggle a:hover {\n background-color: rgba(10, 10, 10, 0.1); }\n .hero.is-info-dark .tabs.is-boxed li.is-active a, .hero.is-info-dark .tabs.is-boxed li.is-active a:hover, .hero.is-info-dark .tabs.is-toggle li.is-active a, .hero.is-info-dark .tabs.is-toggle li.is-active a:hover {\n background-color: #fff;\n border-color: #fff;\n color: #0092FF; }\n .hero.is-info-dark.is-bold {\n background-image: linear-gradient(141deg, #0097cc 0%, #0092FF 71%, #1a77ff 100%); } }\n @media screen and (prefers-color-scheme: dark) and (max-width: 768px) {\n .hero.is-info-dark.is-bold .navbar-menu {\n background-image: linear-gradient(141deg, #0097cc 0%, #0092FF 71%, #1a77ff 100%); } }\n@media (prefers-color-scheme: dark) {\n .hero.is-success-dark {\n background-color: #16DB93;\n color: rgba(0, 0, 0, 0.7); }\n .hero.is-success-dark a:not(.button):not(.dropdown-item):not(.tag),\n .hero.is-success-dark strong {\n color: inherit; }\n .hero.is-success-dark .title {\n color: rgba(0, 0, 0, 0.7); }\n .hero.is-success-dark .subtitle {\n color: rgba(0, 0, 0, 0.9); }\n .hero.is-success-dark .subtitle a:not(.button),\n .hero.is-success-dark .subtitle strong {\n color: rgba(0, 0, 0, 0.7); } }\n @media screen and (prefers-color-scheme: dark) and (max-width: 1023px) {\n .hero.is-success-dark .navbar-menu {\n background-color: #16DB93; } }\n@media (prefers-color-scheme: dark) {\n .hero.is-success-dark .navbar-item,\n .hero.is-success-dark .navbar-link {\n color: rgba(0, 0, 0, 0.7); }\n .hero.is-success-dark a.navbar-item:hover, .hero.is-success-dark a.navbar-item.is-active,\n .hero.is-success-dark .navbar-link:hover,\n .hero.is-success-dark .navbar-link.is-active {\n background-color: #14c483;\n color: rgba(0, 0, 0, 0.7); }\n .hero.is-success-dark .tabs a {\n color: rgba(0, 0, 0, 0.7);\n opacity: 0.9; }\n .hero.is-success-dark .tabs a:hover {\n opacity: 1; }\n .hero.is-success-dark .tabs li.is-active a {\n opacity: 1; }\n .hero.is-success-dark .tabs.is-boxed a, .hero.is-success-dark .tabs.is-toggle a {\n color: rgba(0, 0, 0, 0.7); }\n .hero.is-success-dark .tabs.is-boxed a:hover, .hero.is-success-dark .tabs.is-toggle a:hover {\n background-color: rgba(10, 10, 10, 0.1); }\n .hero.is-success-dark .tabs.is-boxed li.is-active a, .hero.is-success-dark .tabs.is-boxed li.is-active a:hover, .hero.is-success-dark .tabs.is-toggle li.is-active a, .hero.is-success-dark .tabs.is-toggle li.is-active a:hover {\n background-color: rgba(0, 0, 0, 0.7);\n border-color: rgba(0, 0, 0, 0.7);\n color: #16DB93; }\n .hero.is-success-dark.is-bold {\n background-image: linear-gradient(141deg, #08b659 0%, #16DB93 71%, #1cefc5 100%); } }\n @media screen and (prefers-color-scheme: dark) and (max-width: 768px) {\n .hero.is-success-dark.is-bold .navbar-menu {\n background-image: linear-gradient(141deg, #08b659 0%, #16DB93 71%, #1cefc5 100%); } }\n@media (prefers-color-scheme: dark) {\n .hero.is-warning-dark {\n background-color: #FFE900;\n color: rgba(0, 0, 0, 0.7); }\n .hero.is-warning-dark a:not(.button):not(.dropdown-item):not(.tag),\n .hero.is-warning-dark strong {\n color: inherit; }\n .hero.is-warning-dark .title {\n color: rgba(0, 0, 0, 0.7); }\n .hero.is-warning-dark .subtitle {\n color: rgba(0, 0, 0, 0.9); }\n .hero.is-warning-dark .subtitle a:not(.button),\n .hero.is-warning-dark .subtitle strong {\n color: rgba(0, 0, 0, 0.7); } }\n @media screen and (prefers-color-scheme: dark) and (max-width: 1023px) {\n .hero.is-warning-dark .navbar-menu {\n background-color: #FFE900; } }\n@media (prefers-color-scheme: dark) {\n .hero.is-warning-dark .navbar-item,\n .hero.is-warning-dark .navbar-link {\n color: rgba(0, 0, 0, 0.7); }\n .hero.is-warning-dark a.navbar-item:hover, .hero.is-warning-dark a.navbar-item.is-active,\n .hero.is-warning-dark .navbar-link:hover,\n .hero.is-warning-dark .navbar-link.is-active {\n background-color: #e6d200;\n color: rgba(0, 0, 0, 0.7); }\n .hero.is-warning-dark .tabs a {\n color: rgba(0, 0, 0, 0.7);\n opacity: 0.9; }\n .hero.is-warning-dark .tabs a:hover {\n opacity: 1; }\n .hero.is-warning-dark .tabs li.is-active a {\n opacity: 1; }\n .hero.is-warning-dark .tabs.is-boxed a, .hero.is-warning-dark .tabs.is-toggle a {\n color: rgba(0, 0, 0, 0.7); }\n .hero.is-warning-dark .tabs.is-boxed a:hover, .hero.is-warning-dark .tabs.is-toggle a:hover {\n background-color: rgba(10, 10, 10, 0.1); }\n .hero.is-warning-dark .tabs.is-boxed li.is-active a, .hero.is-warning-dark .tabs.is-boxed li.is-active a:hover, .hero.is-warning-dark .tabs.is-toggle li.is-active a, .hero.is-warning-dark .tabs.is-toggle li.is-active a:hover {\n background-color: rgba(0, 0, 0, 0.7);\n border-color: rgba(0, 0, 0, 0.7);\n color: #FFE900; }\n .hero.is-warning-dark.is-bold {\n background-image: linear-gradient(141deg, #cc9800 0%, #FFE900 71%, #edff1a 100%); } }\n @media screen and (prefers-color-scheme: dark) and (max-width: 768px) {\n .hero.is-warning-dark.is-bold .navbar-menu {\n background-image: linear-gradient(141deg, #cc9800 0%, #FFE900 71%, #edff1a 100%); } }\n@media (prefers-color-scheme: dark) {\n .hero.is-danger-dark {\n background-color: #f14668;\n color: #fff; }\n .hero.is-danger-dark a:not(.button):not(.dropdown-item):not(.tag),\n .hero.is-danger-dark strong {\n color: inherit; }\n .hero.is-danger-dark .title {\n color: #fff; }\n .hero.is-danger-dark .subtitle {\n color: rgba(255, 255, 255, 0.9); }\n .hero.is-danger-dark .subtitle a:not(.button),\n .hero.is-danger-dark .subtitle strong {\n color: #fff; } }\n @media screen and (prefers-color-scheme: dark) and (max-width: 1023px) {\n .hero.is-danger-dark .navbar-menu {\n background-color: #f14668; } }\n@media (prefers-color-scheme: dark) {\n .hero.is-danger-dark .navbar-item,\n .hero.is-danger-dark .navbar-link {\n color: rgba(255, 255, 255, 0.7); }\n .hero.is-danger-dark a.navbar-item:hover, .hero.is-danger-dark a.navbar-item.is-active,\n .hero.is-danger-dark .navbar-link:hover,\n .hero.is-danger-dark .navbar-link.is-active {\n background-color: #ef2e55;\n color: #fff; }\n .hero.is-danger-dark .tabs a {\n color: #fff;\n opacity: 0.9; }\n .hero.is-danger-dark .tabs a:hover {\n opacity: 1; }\n .hero.is-danger-dark .tabs li.is-active a {\n opacity: 1; }\n .hero.is-danger-dark .tabs.is-boxed a, .hero.is-danger-dark .tabs.is-toggle a {\n color: #fff; }\n .hero.is-danger-dark .tabs.is-boxed a:hover, .hero.is-danger-dark .tabs.is-toggle a:hover {\n background-color: rgba(10, 10, 10, 0.1); }\n .hero.is-danger-dark .tabs.is-boxed li.is-active a, .hero.is-danger-dark .tabs.is-boxed li.is-active a:hover, .hero.is-danger-dark .tabs.is-toggle li.is-active a, .hero.is-danger-dark .tabs.is-toggle li.is-active a:hover {\n background-color: #fff;\n border-color: #fff;\n color: #f14668; }\n .hero.is-danger-dark.is-bold {\n background-image: linear-gradient(141deg, #fa0a62 0%, #f14668 71%, #f7595f 100%); } }\n @media screen and (prefers-color-scheme: dark) and (max-width: 768px) {\n .hero.is-danger-dark.is-bold .navbar-menu {\n background-image: linear-gradient(141deg, #fa0a62 0%, #f14668 71%, #f7595f 100%); } }\n@media (prefers-color-scheme: dark) {\n .footer {\n background-color: #121212; } }\n\n.hero .title {\n position: relative; }\n .hero .title span {\n display: none; }\n .hero .title::after {\n content: \"\";\n position: absolute;\n top: -108px;\n left: 0;\n right: 0;\n margin: auto;\n width: 500px;\n height: 122px;\n background: url(/assets/images/logo.svg) no-repeat center center; }\n\n.sanic-simple-logo {\n background: url(/assets/images/logo.svg) no-repeat;\n background-size: 270px;\n height: 72px; }\n .sanic-simple-logo img {\n visibility: hidden; }\n\n:root {\n --menu-background: #ededed;\n --menu-divider: #dbdbdb;\n --menu-contrast: #121212; }\n\n.c1 {\n color: #7a7a7a; }\n\n@media (prefers-color-scheme: dark) {\n :root {\n --menu-background: #0a0a0a;\n --menu-divider: #242424;\n --menu-contrast: #7a7a7a; }\n html,\n .navbar {\n background-color: #121212; }\n .footer {\n background-color: #0a0a0a; }\n .sanic-simple-logo {\n background: url(/assets/images/logo-white.svg) no-repeat;\n background-size: 270px; }\n .hero .title::after {\n background: url(/assets/images/logo-white.svg) no-repeat center center; }\n .list {\n background-color: transparent;\n box-shadow: none; }\n .n, .na, .nb, .no, .nd, .ni, .ne, .nl,\n .nn, .nx, .py, .nt, .nv, .bp, .vc, .vg,\n .vi, .vm {\n color: #b5b5b5; }\n .s, .sa, .sb, .sc, .dl, .sd, .s2, .se,\n .sh, .si, .sx, .sr, .s1, .ss {\n background-color: transparent;\n color: #16DB93; }\n .nc {\n color: #FFE900; }\n .c1 {\n color: #4a4a4a; }\n .introduction-table .table tbody tr:last-child td {\n border-bottom-width: 1px; }\n ::-webkit-scrollbar {\n width: 12px;\n height: 12px; }\n ::-webkit-scrollbar-track {\n background: #242424; }\n ::-webkit-scrollbar-thumb {\n background: #121212;\n border-radius: 6px;\n border: 3px solid #242424; }\n ::-webkit-scrollbar-thumb:hover {\n background: #0a0a0a; } }\n\n.burger {\n display: none;\n position: fixed;\n top: 1rem;\n right: 1rem;\n width: 2rem;\n height: 2rem;\n cursor: pointer;\n z-index: 101; }\n .burger span {\n display: block;\n position: absolute;\n height: 2px;\n width: 100%;\n background: var(--menu-contrast);\n border-radius: 2px;\n opacity: 1;\n left: 0;\n transform: rotate(0deg);\n transition: .25s ease-in-out; }\n .burger span:nth-child(1) {\n top: 0px; }\n .burger span:nth-child(2), .burger span:nth-child(3) {\n top: 8px; }\n .burger span:nth-child(4) {\n top: 16px; }\n .burger.is-active span:nth-child(1) {\n top: 18px;\n width: 0%;\n left: 50%; }\n .burger.is-active span:nth-child(2) {\n transform: rotate(45deg); }\n .burger.is-active span:nth-child(3) {\n transform: rotate(-45deg); }\n .burger.is-active span:nth-child(4) {\n top: 18px;\n width: 0%;\n left: 50%; }\n .burger::after {\n content: '';\n display: block;\n position: absolute;\n top: -1rem;\n left: -0.5rem;\n width: 3rem;\n height: 3rem;\n background: var(--menu-background);\n z-index: -1; }\n\n.menu {\n background-color: var(--menu-background);\n width: 360px;\n padding: 2rem;\n height: 100vh;\n overflow: auto;\n position: fixed;\n top: 0;\n left: 0;\n z-index: 100; }\n .menu hr {\n background-color: var(--menu-divider); }\n .menu .is-anchor {\n font-size: 0.75em; }\n .menu .is-anchor a::before {\n content: '# ';\n color: var(--menu-contrast); }\n .menu .menu-label {\n margin-bottom: 1rem; }\n .menu li.is-group > a {\n font-size: 0.85rem; }\n .menu li.is-group > a::after {\n content: '';\n position: relative;\n top: -2px;\n left: 8px;\n display: inline-block;\n width: 0;\n height: 0;\n border-left: 8px solid var(--menu-contrast);\n border-top: 5.33333px solid transparent;\n border-bottom: 5.33333px solid transparent;\n transform: rotate(90deg); }\n .menu li.is-group > a ~ .menu-list {\n transition: all .15s ease-in-out;\n transform: scaleY(1);\n transform-origin: top;\n overflow: hidden;\n opacity: 1;\n margin: 0; }\n .menu li.is-group > a:not(.is-open)::after {\n transform: rotate(0deg); }\n .menu li.is-group > a:not(.is-open) ~ .menu-list {\n transform: scaleY(0);\n opacity: 0;\n font-size: 0; }\n .menu ~ main {\n margin-left: 360px; }\n .menu .anchor-list {\n display: none; }\n .menu .menu-item .is-active + .anchor-list {\n display: block; }\n\n@media screen and (max-width: 1024px) {\n .menu {\n left: -100vw;\n width: 100vw;\n transition: all .25s ease-in-out; }\n .menu.is-active {\n left: 0; }\n .menu ~ main {\n margin-left: 0; }\n .burger {\n display: block; } }\n\n.menu-list li ul {\n margin: 0;\n padding-left: 0; }\n\n.menu-list ul li:not(.is-anchor) {\n margin-left: 0.75em; }\n\n.menu-list .menu-list li a {\n font-size: 0.85em; }\n\ncode {\n color: #4a4a4a; }\n\n.notification code {\n background-color: rgba(237, 237, 237, 0.6); }\n\n@media (prefers-color-scheme: dark) {\n code {\n color: #dbdbdb; }\n .notification code {\n background-color: rgba(36, 36, 36, 0.6); } }\n\na[target=_blank]::after {\n content: \"⇗\";\n margin-left: 0.25em; }\n\na > code {\n border-bottom: 1px solid #ff0d68; }\n a > code:hover {\n background-color: #ff0d68;\n color: white; }\n\nh1 a.anchor,\nh2 a.anchor,\nh3 a.anchor,\nh4 a.anchor,\nh5 a.anchor,\nh6 a.anchor {\n display: none;\n padding-left: 0.375em; }\n\nh1:hover a.anchor,\nh2:hover a.anchor,\nh3:hover a.anchor,\nh4:hover a.anchor,\nh5:hover a.anchor,\nh6:hover a.anchor {\n display: inline; }\n\nh1 {\n margin-left: -2rem; }\n\nh2 {\n margin-left: -1rem;\n margin-top: 3rem; }\n\nh3:not(:first-child) {\n margin-top: 2rem; }\n\narticle {\n margin-left: 2rem; }\n\np + pre,\npre + p,\ndiv.highlight + p,\np + div.highlight,\ndiv.highlight + div.highlight,\np + h4,\np + .code-block,\n.code-block + p,\n.code-block + .code-block,\np + p {\n margin-top: 1rem; }\n\n@media screen and (max-width: 769px) {\n html {\n font-size: 18px; }\n h1 {\n margin-left: 0; }\n h2 {\n margin-left: 0; }\n article {\n margin-left: 0; }\n .section {\n padding: 1rem 0rem;\n max-width: 95vw; } }\n\n@media screen and (min-width: 1216px) {\n .section {\n padding: 3rem 0rem; } }\n\n@media screen and (min-width: 1216px) {\n .section {\n padding: 3rem 0rem; } }\n\n.footer {\n margin-bottom: 4rem; }\n .footer a[target=_blank]::after {\n display: none; }\n\n@media screen and (max-width: 1024px) {\n .footer .level {\n align-items: baseline; }\n .footer a {\n font-size: 0.75em; } }\n\n.hero .subtitle {\n font-size: 3rem;\n font-weight: 700;\n margin-bottom: 1rem; }\n\n.hero .tagline {\n font-family: Fira Code,Source Code Pro,Menlo,Monaco,Consolas,Lucisa Console,monospace;\n font-size: 2rem;\n font-weight: 300;\n margin-bottom: 2rem; }\n\n.language-sh code {\n display: inline-block; }\n .language-sh code::before {\n content: '▶ '; }\n\n.notification {\n margin-top: 2rem; }\n .notification .notification-title {\n font-size: 1.25rem;\n font-weight: 700; }\n .notification.is-note {\n background-color: #ff0d68;\n color: white; }\n .notification.is-new {\n background-color: #833FE3;\n color: white; }\n .notification.is-new::after {\n content: '🌟';\n position: absolute;\n top: 1rem;\n right: 1rem;\n font-size: 2rem; }\n .notification.is-tip::after {\n content: '💡';\n position: absolute;\n top: 1rem;\n right: 1rem;\n font-size: 2rem; }\n\n.ol, .ul,\n.list {\n margin: 1rem 0; }\n .ol .li,\n .ol .list-item, .ul .li,\n .ul .list-item,\n .list .li,\n .list .list-item {\n padding: 0.5rem 0; }\n\n.ul .li {\n margin-left: 1.5rem;\n list-style-type: disc; }\n\n.introduction-table {\n margin: 2rem 0; }\n .introduction-table a[target=_blank]::after {\n display: none; }\n .introduction-table th {\n display: none; }\n\n.docobject h2 :last-child {\n color: #363636; }\n\n.docobject .function-signature {\n color: #1e2024; }\n .docobject .function-signature .param-name {\n color: #ff0d68;\n font-weight: bold; }\n .docobject .function-signature .param-default {\n color: #833FE3;\n font-style: italic; }\n .docobject .function-signature .function-decorator {\n font-style: italic;\n color: #7a7a7a; }\n .docobject .function-signature .param-annotation {\n color: #0092FF; }\n .docobject .function-signature .return-annotation {\n color: #37ae6f; }\n\n.docobject dl {\n display: flex;\n flex-wrap: wrap;\n margin: 0;\n padding: 0; }\n\n.docobject dt {\n flex: 0 0 25%;\n padding: 5px 10px;\n font-weight: bold;\n color: #0092FF; }\n\n.docobject dd {\n flex: 1;\n padding: 5px 10px;\n margin: 0; }\n\n.docobject div.highlight + p,\n.docobject p + div.highlight,\n.docobject div.highlight + div.highlight {\n margin-top: 1rem; }\n\n.docobject .method {\n padding-left: 1rem; }\n .docobject .method h3 {\n margin-left: -1rem; }\n\n.docobject .ol, .docobject .ul, .docobject .list {\n margin: 1rem; }\n\n.mermaid {\n margin-top: 2rem; }\n .mermaid .actor {\n stroke: #ff0d68 !important;\n fill: #ffd9e7 !important; }\n .mermaid .labelBox {\n fill: #cce9ff !important;\n stroke: #0092FF !important; }\n .mermaid .note {\n fill: #fffbcc !important;\n stroke: #FFE900 !important; }\n\n@media (prefers-color-scheme: dark) {\n .docobject h2 :last-child {\n color: #fafafa; }\n .docobject .function-signature {\n color: #b5b5b5; }\n .docobject .function-signature .param-default {\n color: #FFE900; }\n .mermaid text.messageText {\n fill: #fafafa !important; }\n .mermaid .actor {\n fill: #ff0d68 !important; }\n .mermaid .labelBox {\n fill: #0092FF !important; }\n .mermaid .labelText {\n fill: #fafafa !important; }\n .mermaid .note {\n fill: #FFE900 !important; } }\n\nh1 + .code-block,\nh2 + .code-block,\nh3 + .code-block {\n margin-top: 1rem; }\n\n.code-block {\n position: relative; }\n .code-block + .code-block {\n margin-top: 1rem; }\n .code-block:hover .code-block__copy {\n opacity: 1; }\n .code-block .code-block__copy {\n position: absolute;\n right: 10px;\n bottom: 10px;\n width: 36px;\n height: 52px;\n cursor: pointer;\n opacity: 0;\n transition: all 0.3s; }\n .code-block .code-block__copy::before {\n content: \"copied\";\n position: absolute;\n top: -17.33333px;\n margin: auto;\n opacity: 0;\n right: 9px; }\n .code-block .code-block__copy.clicked::before {\n opacity: 1;\n animation: all 0.3s ease-in-out; }\n .code-block .code-block__rectangle {\n position: absolute;\n width: 18px;\n height: 23.29412px;\n transition: all 0.3s ease; }\n .code-block .code-block__filled {\n background-color: #ff0d68;\n left: 5px;\n top: 13px; }\n .code-block .code-block__outlined {\n border: 2px solid #ff0d68;\n background-color: transparent;\n left: -3px;\n top: 5px; }\n .code-block .code-block__copy.clicked .code-block__outlined {\n left: -19px;\n top: 13px;\n background-color: #ff0d68; }\n\n.additional-attributes.details {\n display: flex;\n flex-direction: column;\n width: 100%; }\n .additional-attributes.details .code-block {\n display: none;\n width: 100%; }\n .additional-attributes.details::before {\n content: \"▼ \" attr(title);\n display: block;\n background-color: #b5b5b5;\n padding: 10px;\n cursor: pointer;\n width: 100%;\n box-sizing: border-box; }\n .additional-attributes.details.is-active .code-block {\n display: block; }\n .additional-attributes.details.is-active::before {\n content: \"▲ \" attr(title);\n background-color: #dbdbdb; }\n\n@media (prefers-color-scheme: dark) {\n .additional-attributes.details::before {\n background-color: #363636; }\n .additional-attributes.details.is-active::before {\n background-color: #4a4a4a; } }\n\n.tabs .tab-content {\n display: none; }\n\n.table-of-contents {\n position: fixed;\n right: 0;\n bottom: 0;\n z-index: 1000;\n max-width: 500px;\n padding: 1rem 2rem;\n background-color: #fafafa;\n box-shadow: 0 0 2px rgba(63, 63, 68, 0.5); }\n @media (prefers-color-scheme: dark) {\n .table-of-contents {\n background-color: #0a0a0a;\n box-shadow: 0 0 2px rgba(191, 191, 191, 0.5); } }\n .table-of-contents .table-of-contents-item {\n display: block;\n margin-bottom: 0.5rem;\n text-decoration: none; }\n .table-of-contents .table-of-contents-item:hover {\n text-decoration: underline;\n color: #ff0d68; }\n .table-of-contents .table-of-contents-item:hover strong, .table-of-contents .table-of-contents-item:hover small {\n color: #ff0d68; }\n .table-of-contents .table-of-contents-item strong {\n color: #121212;\n font-size: 1.15em;\n display: block;\n line-height: 1rem;\n margin-top: 0.75rem; }\n .table-of-contents .table-of-contents-item small {\n color: #7a7a7a;\n font-size: 0.85em; }\n @media (prefers-color-scheme: dark) {\n .table-of-contents .table-of-contents-item strong {\n color: #dbdbdb; } }\n @media (max-width: 768px) {\n .table-of-contents {\n position: static;\n max-width: calc(100vw - 2rem); }\n .table-of-contents .table-of-contents-item {\n display: flex;\n flex-direction: row-reverse;\n justify-content: start; }\n .table-of-contents .table-of-contents-item strong {\n display: inline;\n margin: 0 0 0 0.75rem; } }\n.loading-bar {\n position: fixed;\n top: 0;\n left: 0;\n width: 100%;\n height: 3px;\n background-color: transparent;\n z-index: 9999; }\n .loading-bar.is-loading {\n background-color: #ff0d68;\n animation: pulsingLoading 1s linear infinite; }\n\n@keyframes pulsingLoading {\n 0%, 100% {\n transform: scaleX(1);\n opacity: 1; }\n 50% {\n transform: scaleX(0.25);\n opacity: 0.5; } }\n\n.changelog .ol .li, .changelog .ol .list-item, .changelog .ul .li, .changelog .ul .list-item, .changelog .list .li, .changelog .list .list-item {\n padding: 0; }\n\n.sponsors {\n display: flex;\n flex-wrap: wrap;\n justify-content: center;\n text-align: center;\n padding: 0.25rem 0; }\n .sponsors .button {\n margin-left: 1rem; }\n\n@media screen and (min-width: 769px) {\n .hero.is-large .hero-body {\n padding: 18rem 6rem 3rem; } }\n\n@media screen and (max-width: 769px) {\n .hero {\n height: 100vh;\n margin-top: 15vh; }\n .hero .hero-body {\n padding: 3rem 1.5rem;\n display: flex;\n flex-direction: column;\n justify-content: center; }\n .hero .title::after {\n width: calc(100vw - 1.5rem);\n background: url(/assets/images/logo-white.svg) no-repeat center center;\n background-size: 100% auto; }\n .hero .subtitle {\n margin-top: 1rem;\n font-size: 1.4rem; }\n .hero .tagline {\n font-size: 1.1rem; } }\n\n.home .tab-container {\n display: flex; }\n .home .tab-container .tabs {\n flex-shrink: 0;\n width: 200px; }\n .home .tab-container .tabs ul {\n display: flex;\n flex-direction: column;\n border-bottom: none; }\n .home .tab-container .tabs li {\n display: block;\n width: 100%; }\n .home .tab-container .tabs li a {\n display: block;\n padding: 0.5em 1em;\n text-align: left; }\n .home .tab-container .tab-display {\n flex-grow: 1;\n min-width: 0;\n padding-left: 20px; }\n @media screen and (max-width: 768px) {\n .home .tab-container {\n flex-direction: column; }\n .home .tab-container .tabs {\n width: 100%; }\n .home .tab-container .tabs ul {\n display: block;\n overflow-y: auto; }\n .home .tab-container .tabs li {\n display: block; }\n .home .tab-container .tab-display {\n padding-left: 0; } }\nfooter .level,\nfooter .level .level-right,\nfooter .level .level-left {\n display: flex !important; }\n\n.tabs li a {\n font-size: 0.7rem; }\n\n.box {\n box-shadow: 0 2px 3px rgba(10, 10, 10, 0.1), 0 0 0 1px rgba(10, 10, 10, 0.1); }\n\n.container {\n padding: 0 0.5rem; }\n\n@media (prefers-color-scheme: dark) {\n .box {\n box-shadow: 0 2px 3px rgba(128, 128, 128, 0.1), 0 0 0 1px rgba(128, 128, 128, 0.1); } }\n" }, { "path": "guide/public/index.html", "content": "\n\n\n \n \n Sanic Framework\n \n \n \n

Redirecting to /en/

\n \n\n" }, { "path": "guide/public/web/browserconfig.xml", "content": "\n\n \n \n \n #da532c\n \n \n\n" }, { "path": "guide/public/web/robots.txt", "content": "User-agent: *\nAllow: /\nSitemap: https://sanic.dev/sitemap.xml\nHost: https://sanic.dev\n" }, { "path": "guide/public/web/site.webmanifest", "content": "{\n \"name\": \"Sanic\",\n \"short_name\": \"Sanic\",\n \"icons\": [\n {\n \"src\": \"/android-chrome-192x192.png\",\n \"sizes\": \"192x192\",\n \"type\": \"image/png\"\n },\n {\n \"src\": \"/android-chrome-512x512.png\",\n \"sizes\": \"512x512\",\n \"type\": \"image/png\"\n }\n ],\n \"theme_color\": \"#ffffff\",\n \"background_color\": \"#ffffff\",\n \"display\": \"standalone\"\n}\n" }, { "path": "guide/requirements.txt", "content": "sanic>=23.12\nsanic-ext>=23.12\nmsgspec\npython-frontmatter\npygments\ndocstring-parser\nlibsass\nmistune\n" }, { "path": "guide/server.py", "content": "\"\"\"Sanic User Guide\n\nhttps://sanic.dev\n\nBuilt using the SHH stack:\n- Sanic\n- html5tagger\n- HTMX\"\"\"\n\nfrom pathlib import Path\n\nfrom webapp.worker.factory import create_app\n\n\napp = create_app(Path(__file__).parent)\n" }, { "path": "guide/style/bulma/LICENSE", "content": "The MIT License (MIT)\n\nCopyright (c) 2022 Jeremy Thomas\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": "guide/style/bulma/bulma.sass", "content": "@charset \"utf-8\"\n/*! bulma.io v0.9.4 | MIT License | github.com/jgthms/bulma */\n@import \"sass/utilities/_all\"\n@import \"sass/base/_all\"\n@import \"sass/elements/_all\"\n@import \"sass/form/_all\"\n@import \"sass/components/_all\"\n@import \"sass/grid/_all\"\n@import \"sass/helpers/_all\"\n@import \"sass/layout/_all\"\n" }, { "path": "guide/style/bulma/sass/base/_all.sass", "content": "/* Bulma Base */\n@charset \"utf-8\"\n\n@import \"minireset\"\n@import \"generic\"\n@import \"animations\"\n" }, { "path": "guide/style/bulma/sass/base/animations.sass", "content": "@keyframes spinAround\n from\n transform: rotate(0deg)\n to\n transform: rotate(359deg)\n" }, { "path": "guide/style/bulma/sass/base/generic.sass", "content": "@import \"../utilities/mixins\"\n\n$body-background-color: $scheme-main !default\n$body-size: 16px !default\n$body-min-width: 300px !default\n$body-rendering: optimizeLegibility !default\n$body-family: $family-primary !default\n$body-overflow-x: hidden !default\n$body-overflow-y: scroll !default\n\n$body-color: $text !default\n$body-font-size: 1em !default\n$body-weight: $weight-normal !default\n$body-line-height: 1.5 !default\n\n$code-family: $family-code !default\n$code-padding: 0.25em 0.5em 0.25em !default\n$code-weight: normal !default\n$code-size: 0.875em !default\n\n$small-font-size: 0.875em !default\n\n$hr-background-color: $background !default\n$hr-height: 2px !default\n$hr-margin: 1.5rem 0 !default\n\n$strong-color: $text-strong !default\n$strong-weight: $weight-bold !default\n\n$pre-font-size: 0.875em !default\n$pre-padding: 1.25rem 1.5rem !default\n$pre-code-font-size: 1em !default\n\nhtml\n background-color: $body-background-color\n font-size: $body-size\n -moz-osx-font-smoothing: grayscale\n -webkit-font-smoothing: antialiased\n min-width: $body-min-width\n overflow-x: $body-overflow-x\n overflow-y: $body-overflow-y\n text-rendering: $body-rendering\n text-size-adjust: 100%\n\narticle,\naside,\nfigure,\nfooter,\nheader,\nhgroup,\nsection\n display: block\n\nbody,\nbutton,\ninput,\noptgroup,\nselect,\ntextarea\n font-family: $body-family\n\ncode,\npre\n -moz-osx-font-smoothing: auto\n -webkit-font-smoothing: auto\n font-family: $code-family\n\nbody\n color: $body-color\n font-size: $body-font-size\n font-weight: $body-weight\n line-height: $body-line-height\n\n// Inline\n\na\n color: $link\n cursor: pointer\n text-decoration: none\n strong\n color: currentColor\n &:hover\n color: $link-hover\n\ncode\n background-color: $code-background\n color: $code\n font-size: $code-size\n font-weight: $code-weight\n padding: $code-padding\n\nhr\n background-color: $hr-background-color\n border: none\n display: block\n height: $hr-height\n margin: $hr-margin\n\nimg\n height: auto\n max-width: 100%\n\ninput[type=\"checkbox\"],\ninput[type=\"radio\"]\n vertical-align: baseline\n\nsmall\n font-size: $small-font-size\n\nspan\n font-style: inherit\n font-weight: inherit\n\nstrong\n color: $strong-color\n font-weight: $strong-weight\n\n// Block\n\nfieldset\n border: none\n\npre\n +overflow-touch\n background-color: $pre-background\n color: $pre\n font-size: $pre-font-size\n overflow-x: auto\n padding: $pre-padding\n white-space: pre\n word-wrap: normal\n code\n background-color: transparent\n color: currentColor\n font-size: $pre-code-font-size\n padding: 0\n\ntable\n td,\n th\n vertical-align: top\n &:not([align])\n text-align: inherit\n th\n color: $text-strong\n" }, { "path": "guide/style/bulma/sass/base/helpers.sass", "content": "@warn \"The helpers.sass file is DEPRECATED. It has moved into its own /helpers folder. Please import sass/helpers/_all instead.\"\n" }, { "path": "guide/style/bulma/sass/base/minireset.sass", "content": "/*! minireset.css v0.0.6 | MIT License | github.com/jgthms/minireset.css */\n// Blocks\nhtml,\nbody,\np,\nol,\nul,\nli,\ndl,\ndt,\ndd,\nblockquote,\nfigure,\nfieldset,\nlegend,\ntextarea,\npre,\niframe,\nhr,\nh1,\nh2,\nh3,\nh4,\nh5,\nh6\n margin: 0\n padding: 0\n\n// Headings\nh1,\nh2,\nh3,\nh4,\nh5,\nh6\n font-size: 100%\n font-weight: normal\n\n// List\nul\n list-style: none\n\n// Form\nbutton,\ninput,\nselect,\ntextarea\n margin: 0\n\n// Box sizing\nhtml\n box-sizing: border-box\n\n*\n &,\n &::before,\n &::after\n box-sizing: inherit\n\n// Media\nimg,\nvideo\n height: auto\n max-width: 100%\n\n// Iframe\niframe\n border: 0\n\n// Table\ntable\n border-collapse: collapse\n border-spacing: 0\n\ntd,\nth\n padding: 0\n &:not([align])\n text-align: inherit\n" }, { "path": "guide/style/bulma/sass/components/_all.sass", "content": "/* Bulma Components */\n@charset \"utf-8\"\n\n@import \"breadcrumb\"\n@import \"card\"\n@import \"dropdown\"\n@import \"level\"\n@import \"media\"\n@import \"menu\"\n@import \"message\"\n@import \"modal\"\n@import \"navbar\"\n@import \"pagination\"\n@import \"panel\"\n@import \"tabs\"\n" }, { "path": "guide/style/bulma/sass/components/breadcrumb.sass", "content": "@import \"../utilities/mixins\"\n\n$breadcrumb-item-color: $link !default\n$breadcrumb-item-hover-color: $link-hover !default\n$breadcrumb-item-active-color: $text-strong !default\n\n$breadcrumb-item-padding-vertical: 0 !default\n$breadcrumb-item-padding-horizontal: 0.75em !default\n\n$breadcrumb-item-separator-color: $border-hover !default\n\n.breadcrumb\n @extend %block\n @extend %unselectable\n font-size: $size-normal\n white-space: nowrap\n a\n align-items: center\n color: $breadcrumb-item-color\n display: flex\n justify-content: center\n padding: $breadcrumb-item-padding-vertical $breadcrumb-item-padding-horizontal\n &:hover\n color: $breadcrumb-item-hover-color\n li\n align-items: center\n display: flex\n &:first-child a\n +ltr-property(\"padding\", 0, false)\n &.is-active\n a\n color: $breadcrumb-item-active-color\n cursor: default\n pointer-events: none\n & + li::before\n color: $breadcrumb-item-separator-color\n content: \"\\0002f\"\n ul,\n ol\n align-items: flex-start\n display: flex\n flex-wrap: wrap\n justify-content: flex-start\n .icon\n &:first-child\n +ltr-property(\"margin\", 0.5em)\n &:last-child\n +ltr-property(\"margin\", 0.5em, false)\n // Alignment\n &.is-centered\n ol,\n ul\n justify-content: center\n &.is-right\n ol,\n ul\n justify-content: flex-end\n // Sizes\n &.is-small\n font-size: $size-small\n &.is-medium\n font-size: $size-medium\n &.is-large\n font-size: $size-large\n // Styles\n &.has-arrow-separator\n li + li::before\n content: \"\\02192\"\n &.has-bullet-separator\n li + li::before\n content: \"\\02022\"\n &.has-dot-separator\n li + li::before\n content: \"\\000b7\"\n &.has-succeeds-separator\n li + li::before\n content: \"\\0227B\"\n" }, { "path": "guide/style/bulma/sass/components/card.sass", "content": "@import \"../utilities/mixins\"\n\n$card-color: $text !default\n$card-background-color: $scheme-main !default\n$card-shadow: $shadow !default\n$card-radius: 0.25rem !default\n\n$card-header-background-color: transparent !default\n$card-header-color: $text-strong !default\n$card-header-padding: 0.75rem 1rem !default\n$card-header-shadow: 0 0.125em 0.25em rgba($scheme-invert, 0.1) !default\n$card-header-weight: $weight-bold !default\n\n$card-content-background-color: transparent !default\n$card-content-padding: 1.5rem !default\n\n$card-footer-background-color: transparent !default\n$card-footer-border-top: 1px solid $border-light !default\n$card-footer-padding: 0.75rem !default\n\n$card-media-margin: $block-spacing !default\n\n.card\n background-color: $card-background-color\n border-radius: $card-radius\n box-shadow: $card-shadow\n color: $card-color\n max-width: 100%\n position: relative\n\n%card-item\n &:first-child\n border-top-left-radius: $card-radius\n border-top-right-radius: $card-radius\n &:last-child\n border-bottom-left-radius: $card-radius\n border-bottom-right-radius: $card-radius\n\n.card-header\n @extend %card-item\n background-color: $card-header-background-color\n align-items: stretch\n box-shadow: $card-header-shadow\n display: flex\n\n.card-header-title\n align-items: center\n color: $card-header-color\n display: flex\n flex-grow: 1\n font-weight: $card-header-weight\n padding: $card-header-padding\n &.is-centered\n justify-content: center\n\n.card-header-icon\n +reset\n align-items: center\n cursor: pointer\n display: flex\n justify-content: center\n padding: $card-header-padding\n\n.card-image\n display: block\n position: relative\n &:first-child\n img\n border-top-left-radius: $card-radius\n border-top-right-radius: $card-radius\n &:last-child\n img\n border-bottom-left-radius: $card-radius\n border-bottom-right-radius: $card-radius\n\n.card-content\n @extend %card-item\n background-color: $card-content-background-color\n padding: $card-content-padding\n\n.card-footer\n @extend %card-item\n background-color: $card-footer-background-color\n border-top: $card-footer-border-top\n align-items: stretch\n display: flex\n\n.card-footer-item\n align-items: center\n display: flex\n flex-basis: 0\n flex-grow: 1\n flex-shrink: 0\n justify-content: center\n padding: $card-footer-padding\n &:not(:last-child)\n +ltr-property(\"border\", $card-footer-border-top)\n\n// Combinations\n\n.card\n .media:not(:last-child)\n margin-bottom: $card-media-margin\n" }, { "path": "guide/style/bulma/sass/components/dropdown.sass", "content": "@import \"../utilities/mixins\"\n\n$dropdown-menu-min-width: 12rem !default\n\n$dropdown-content-background-color: $scheme-main !default\n$dropdown-content-arrow: $link !default\n$dropdown-content-offset: 4px !default\n$dropdown-content-padding-bottom: 0.5rem !default\n$dropdown-content-padding-top: 0.5rem !default\n$dropdown-content-radius: $radius !default\n$dropdown-content-shadow: $shadow !default\n$dropdown-content-z: 20 !default\n\n$dropdown-item-color: $text !default\n$dropdown-item-hover-color: $scheme-invert !default\n$dropdown-item-hover-background-color: $background !default\n$dropdown-item-active-color: $link-invert !default\n$dropdown-item-active-background-color: $link !default\n\n$dropdown-divider-background-color: $border-light !default\n\n.dropdown\n display: inline-flex\n position: relative\n vertical-align: top\n &.is-active,\n &.is-hoverable:hover\n .dropdown-menu\n display: block\n &.is-right\n .dropdown-menu\n left: auto\n right: 0\n &.is-up\n .dropdown-menu\n bottom: 100%\n padding-bottom: $dropdown-content-offset\n padding-top: initial\n top: auto\n\n.dropdown-menu\n display: none\n +ltr-position(0, false)\n min-width: $dropdown-menu-min-width\n padding-top: $dropdown-content-offset\n position: absolute\n top: 100%\n z-index: $dropdown-content-z\n\n.dropdown-content\n background-color: $dropdown-content-background-color\n border-radius: $dropdown-content-radius\n box-shadow: $dropdown-content-shadow\n padding-bottom: $dropdown-content-padding-bottom\n padding-top: $dropdown-content-padding-top\n\n.dropdown-item\n color: $dropdown-item-color\n display: block\n font-size: 0.875rem\n line-height: 1.5\n padding: 0.375rem 1rem\n position: relative\n\na.dropdown-item,\nbutton.dropdown-item\n +ltr-property(\"padding\", 3rem)\n text-align: inherit\n white-space: nowrap\n width: 100%\n &:hover\n background-color: $dropdown-item-hover-background-color\n color: $dropdown-item-hover-color\n &.is-active\n background-color: $dropdown-item-active-background-color\n color: $dropdown-item-active-color\n\n.dropdown-divider\n background-color: $dropdown-divider-background-color\n border: none\n display: block\n height: 1px\n margin: 0.5rem 0\n" }, { "path": "guide/style/bulma/sass/components/level.sass", "content": "@import \"../utilities/mixins\"\n\n$level-item-spacing: ($block-spacing * 0.5) !default\n\n.level\n @extend %block\n align-items: center\n justify-content: space-between\n code\n border-radius: $radius\n img\n display: inline-block\n vertical-align: top\n // Modifiers\n &.is-mobile\n display: flex\n .level-left,\n .level-right\n display: flex\n .level-left + .level-right\n margin-top: 0\n .level-item\n &:not(:last-child)\n margin-bottom: 0\n +ltr-property(\"margin\", $level-item-spacing)\n &:not(.is-narrow)\n flex-grow: 1\n // Responsiveness\n +tablet\n display: flex\n & > .level-item\n &:not(.is-narrow)\n flex-grow: 1\n\n.level-item\n align-items: center\n display: flex\n flex-basis: auto\n flex-grow: 0\n flex-shrink: 0\n justify-content: center\n .title,\n .subtitle\n margin-bottom: 0\n // Responsiveness\n +mobile\n &:not(:last-child)\n margin-bottom: $level-item-spacing\n\n.level-left,\n.level-right\n flex-basis: auto\n flex-grow: 0\n flex-shrink: 0\n .level-item\n // Modifiers\n &.is-flexible\n flex-grow: 1\n // Responsiveness\n +tablet\n &:not(:last-child)\n +ltr-property(\"margin\", $level-item-spacing)\n\n.level-left\n align-items: center\n justify-content: flex-start\n // Responsiveness\n +mobile\n & + .level-right\n margin-top: 1.5rem\n +tablet\n display: flex\n\n.level-right\n align-items: center\n justify-content: flex-end\n // Responsiveness\n +tablet\n display: flex\n" }, { "path": "guide/style/bulma/sass/components/media.sass", "content": "@import \"../utilities/mixins\"\n\n$media-border-color: bulmaRgba($border, 0.5) !default\n$media-border-size: 1px !default\n$media-spacing: 1rem !default\n$media-spacing-large: 1.5rem !default\n$media-content-spacing: 0.75rem !default\n$media-level-1-spacing: 0.75rem !default\n$media-level-1-content-spacing: 0.5rem !default\n$media-level-2-spacing: 0.5rem !default\n\n.media\n align-items: flex-start\n display: flex\n text-align: inherit\n .content:not(:last-child)\n margin-bottom: $media-content-spacing\n .media\n border-top: $media-border-size solid $media-border-color\n display: flex\n padding-top: $media-level-1-spacing\n .content:not(:last-child),\n .control:not(:last-child)\n margin-bottom: $media-level-1-content-spacing\n .media\n padding-top: $media-level-2-spacing\n & + .media\n margin-top: $media-level-2-spacing\n & + .media\n border-top: $media-border-size solid $media-border-color\n margin-top: $media-spacing\n padding-top: $media-spacing\n // Sizes\n &.is-large\n & + .media\n margin-top: $media-spacing-large\n padding-top: $media-spacing-large\n\n.media-left,\n.media-right\n flex-basis: auto\n flex-grow: 0\n flex-shrink: 0\n\n.media-left\n +ltr-property(\"margin\", $media-spacing)\n\n.media-right\n +ltr-property(\"margin\", $media-spacing, false)\n\n.media-content\n flex-basis: auto\n flex-grow: 1\n flex-shrink: 1\n text-align: inherit\n\n+mobile\n .media-content\n overflow-x: auto\n" }, { "path": "guide/style/bulma/sass/components/menu.sass", "content": "@import \"../utilities/mixins\"\n\n$menu-item-color: $text !default\n$menu-item-radius: $radius-small !default\n$menu-item-hover-color: $text-strong !default\n$menu-item-hover-background-color: $background !default\n$menu-item-active-color: $link-invert !default\n$menu-item-active-background-color: $link !default\n\n$menu-list-border-left: 1px solid $border !default\n$menu-list-line-height: 1.25 !default\n$menu-list-link-padding: 0.5em 0.75em !default\n$menu-nested-list-margin: 0.75em !default\n$menu-nested-list-padding-left: 0.75em !default\n\n$menu-label-color: $text-light !default\n$menu-label-font-size: 0.75em !default\n$menu-label-letter-spacing: 0.1em !default\n$menu-label-spacing: 1em !default\n\n.menu\n font-size: $size-normal\n // Sizes\n &.is-small\n font-size: $size-small\n &.is-medium\n font-size: $size-medium\n &.is-large\n font-size: $size-large\n\n.menu-list\n line-height: $menu-list-line-height\n a\n border-radius: $menu-item-radius\n color: $menu-item-color\n display: block\n padding: $menu-list-link-padding\n &:hover\n background-color: $menu-item-hover-background-color\n color: $menu-item-hover-color\n // Modifiers\n &.is-active\n background-color: $menu-item-active-background-color\n color: $menu-item-active-color\n li\n ul\n +ltr-property(\"border\", $menu-list-border-left, false)\n margin: $menu-nested-list-margin\n +ltr-property(\"padding\", $menu-nested-list-padding-left, false)\n\n.menu-label\n color: $menu-label-color\n font-size: $menu-label-font-size\n letter-spacing: $menu-label-letter-spacing\n text-transform: uppercase\n &:not(:first-child)\n margin-top: $menu-label-spacing\n &:not(:last-child)\n margin-bottom: $menu-label-spacing\n" }, { "path": "guide/style/bulma/sass/components/message.sass", "content": "@import \"../utilities/mixins\"\n\n$message-background-color: $background !default\n$message-radius: $radius !default\n\n$message-header-background-color: $text !default\n$message-header-color: $text-invert !default\n$message-header-weight: $weight-bold !default\n$message-header-padding: 0.75em 1em !default\n$message-header-radius: $radius !default\n\n$message-body-border-color: $border !default\n$message-body-border-width: 0 0 0 4px !default\n$message-body-color: $text !default\n$message-body-padding: 1.25em 1.5em !default\n$message-body-radius: $radius !default\n\n$message-body-pre-background-color: $scheme-main !default\n$message-body-pre-code-background-color: transparent !default\n\n$message-header-body-border-width: 0 !default\n$message-colors: $colors !default\n\n.message\n @extend %block\n background-color: $message-background-color\n border-radius: $message-radius\n font-size: $size-normal\n strong\n color: currentColor\n a:not(.button):not(.tag):not(.dropdown-item)\n color: currentColor\n text-decoration: underline\n // Sizes\n &.is-small\n font-size: $size-small\n &.is-medium\n font-size: $size-medium\n &.is-large\n font-size: $size-large\n // Colors\n @each $name, $components in $message-colors\n $color: nth($components, 1)\n $color-invert: nth($components, 2)\n $color-light: null\n $color-dark: null\n\n @if length($components) >= 3\n $color-light: nth($components, 3)\n @if length($components) >= 4\n $color-dark: nth($components, 4)\n @else\n $color-luminance: colorLuminance($color)\n $darken-percentage: $color-luminance * 70%\n $desaturate-percentage: $color-luminance * 30%\n $color-dark: desaturate(darken($color, $darken-percentage), $desaturate-percentage)\n @else\n $color-lightning: max((100% - lightness($color)) - 2%, 0%)\n $color-light: lighten($color, $color-lightning)\n\n &.is-#{$name}\n background-color: $color-light\n .message-header\n background-color: $color\n color: $color-invert\n .message-body\n border-color: $color\n color: $color-dark\n\n.message-header\n align-items: center\n background-color: $message-header-background-color\n border-radius: $message-header-radius $message-header-radius 0 0\n color: $message-header-color\n display: flex\n font-weight: $message-header-weight\n justify-content: space-between\n line-height: 1.25\n padding: $message-header-padding\n position: relative\n .delete\n flex-grow: 0\n flex-shrink: 0\n +ltr-property(\"margin\", 0.75em, false)\n & + .message-body\n border-width: $message-header-body-border-width\n border-top-left-radius: 0\n border-top-right-radius: 0\n\n.message-body\n border-color: $message-body-border-color\n border-radius: $message-body-radius\n border-style: solid\n border-width: $message-body-border-width\n color: $message-body-color\n padding: $message-body-padding\n code,\n pre\n background-color: $message-body-pre-background-color\n pre code\n background-color: $message-body-pre-code-background-color\n" }, { "path": "guide/style/bulma/sass/components/modal.sass", "content": "@import \"../utilities/mixins\"\n\n$modal-z: 40 !default\n\n$modal-background-background-color: bulmaRgba($scheme-invert, 0.86) !default\n\n$modal-content-width: 640px !default\n$modal-content-margin-mobile: 20px !default\n$modal-content-spacing-mobile: 160px !default\n$modal-content-spacing-tablet: 40px !default\n\n$modal-close-dimensions: 40px !default\n$modal-close-right: 20px !default\n$modal-close-top: 20px !default\n\n$modal-card-spacing: 40px !default\n\n$modal-card-head-background-color: $background !default\n$modal-card-head-border-bottom: 1px solid $border !default\n$modal-card-head-padding: 20px !default\n$modal-card-head-radius: $radius-large !default\n\n$modal-card-title-color: $text-strong !default\n$modal-card-title-line-height: 1 !default\n$modal-card-title-size: $size-4 !default\n\n$modal-card-foot-radius: $radius-large !default\n$modal-card-foot-border-top: 1px solid $border !default\n\n$modal-card-body-background-color: $scheme-main !default\n$modal-card-body-padding: 20px !default\n\n$modal-breakpoint: $tablet !default\n\n.modal\n @extend %overlay\n align-items: center\n display: none\n flex-direction: column\n justify-content: center\n overflow: hidden\n position: fixed\n z-index: $modal-z\n // Modifiers\n &.is-active\n display: flex\n\n.modal-background\n @extend %overlay\n background-color: $modal-background-background-color\n\n.modal-content,\n.modal-card\n margin: 0 $modal-content-margin-mobile\n max-height: calc(100vh - #{$modal-content-spacing-mobile})\n overflow: auto\n position: relative\n width: 100%\n // Responsiveness\n +from($modal-breakpoint)\n margin: 0 auto\n max-height: calc(100vh - #{$modal-content-spacing-tablet})\n width: $modal-content-width\n\n.modal-close\n @extend %delete\n background: none\n height: $modal-close-dimensions\n position: fixed\n +ltr-position($modal-close-right)\n top: $modal-close-top\n width: $modal-close-dimensions\n\n.modal-card\n display: flex\n flex-direction: column\n max-height: calc(100vh - #{$modal-card-spacing})\n overflow: hidden\n -ms-overflow-y: visible\n\n.modal-card-head,\n.modal-card-foot\n align-items: center\n background-color: $modal-card-head-background-color\n display: flex\n flex-shrink: 0\n justify-content: flex-start\n padding: $modal-card-head-padding\n position: relative\n\n.modal-card-head\n border-bottom: $modal-card-head-border-bottom\n border-top-left-radius: $modal-card-head-radius\n border-top-right-radius: $modal-card-head-radius\n\n.modal-card-title\n color: $modal-card-title-color\n flex-grow: 1\n flex-shrink: 0\n font-size: $modal-card-title-size\n line-height: $modal-card-title-line-height\n\n.modal-card-foot\n border-bottom-left-radius: $modal-card-foot-radius\n border-bottom-right-radius: $modal-card-foot-radius\n border-top: $modal-card-foot-border-top\n .button\n &:not(:last-child)\n +ltr-property(\"margin\", 0.5em)\n\n.modal-card-body\n +overflow-touch\n background-color: $modal-card-body-background-color\n flex-grow: 1\n flex-shrink: 1\n overflow: auto\n padding: $modal-card-body-padding\n" }, { "path": "guide/style/bulma/sass/components/navbar.sass", "content": "@import \"../utilities/mixins\"\n\n$navbar-background-color: $scheme-main !default\n$navbar-box-shadow-size: 0 2px 0 0 !default\n$navbar-box-shadow-color: $background !default\n$navbar-height: 3.25rem !default\n$navbar-padding-vertical: 1rem !default\n$navbar-padding-horizontal: 2rem !default\n$navbar-z: 30 !default\n$navbar-fixed-z: 30 !default\n\n$navbar-item-color: $text !default\n$navbar-item-hover-color: $link !default\n$navbar-item-hover-background-color: $scheme-main-bis !default\n$navbar-item-active-color: $scheme-invert !default\n$navbar-item-active-background-color: transparent !default\n$navbar-item-img-max-height: 1.75rem !default\n\n$navbar-burger-color: $navbar-item-color !default\n\n$navbar-tab-hover-background-color: transparent !default\n$navbar-tab-hover-border-bottom-color: $link !default\n$navbar-tab-active-color: $link !default\n$navbar-tab-active-background-color: transparent !default\n$navbar-tab-active-border-bottom-color: $link !default\n$navbar-tab-active-border-bottom-style: solid !default\n$navbar-tab-active-border-bottom-width: 3px !default\n\n$navbar-dropdown-background-color: $scheme-main !default\n$navbar-dropdown-border-top: 2px solid $border !default\n$navbar-dropdown-offset: -4px !default\n$navbar-dropdown-arrow: $link !default\n$navbar-dropdown-radius: $radius-large !default\n$navbar-dropdown-z: 20 !default\n\n$navbar-dropdown-boxed-radius: $radius-large !default\n$navbar-dropdown-boxed-shadow: 0 8px 8px bulmaRgba($scheme-invert, 0.1), 0 0 0 1px bulmaRgba($scheme-invert, 0.1) !default\n\n$navbar-dropdown-item-hover-color: $scheme-invert !default\n$navbar-dropdown-item-hover-background-color: $background !default\n$navbar-dropdown-item-active-color: $link !default\n$navbar-dropdown-item-active-background-color: $background !default\n\n$navbar-divider-background-color: $background !default\n$navbar-divider-height: 2px !default\n\n$navbar-bottom-box-shadow-size: 0 -2px 0 0 !default\n\n$navbar-breakpoint: $desktop !default\n\n$navbar-colors: $colors !default\n\n=navbar-fixed\n left: 0\n position: fixed\n right: 0\n z-index: $navbar-fixed-z\n\n.navbar\n background-color: $navbar-background-color\n min-height: $navbar-height\n position: relative\n z-index: $navbar-z\n @each $name, $pair in $navbar-colors\n $color: nth($pair, 1)\n $color-invert: nth($pair, 2)\n &.is-#{$name}\n background-color: $color\n color: $color-invert\n .navbar-brand\n & > .navbar-item,\n .navbar-link\n color: $color-invert\n & > a.navbar-item,\n .navbar-link\n &:focus,\n &:hover,\n &.is-active\n background-color: bulmaDarken($color, 5%)\n color: $color-invert\n .navbar-link\n &::after\n border-color: $color-invert\n .navbar-burger\n color: $color-invert\n +from($navbar-breakpoint)\n .navbar-start,\n .navbar-end\n & > .navbar-item,\n .navbar-link\n color: $color-invert\n & > a.navbar-item,\n .navbar-link\n &:focus,\n &:hover,\n &.is-active\n background-color: bulmaDarken($color, 5%)\n color: $color-invert\n .navbar-link\n &::after\n border-color: $color-invert\n .navbar-item.has-dropdown:focus .navbar-link,\n .navbar-item.has-dropdown:hover .navbar-link,\n .navbar-item.has-dropdown.is-active .navbar-link\n background-color: bulmaDarken($color, 5%)\n color: $color-invert\n .navbar-dropdown\n a.navbar-item\n &.is-active\n background-color: $color\n color: $color-invert\n & > .container\n align-items: stretch\n display: flex\n min-height: $navbar-height\n width: 100%\n &.has-shadow\n box-shadow: $navbar-box-shadow-size $navbar-box-shadow-color\n &.is-fixed-bottom,\n &.is-fixed-top\n +navbar-fixed\n &.is-fixed-bottom\n bottom: 0\n &.has-shadow\n box-shadow: $navbar-bottom-box-shadow-size $navbar-box-shadow-color\n &.is-fixed-top\n top: 0\n\nhtml,\nbody\n &.has-navbar-fixed-top\n padding-top: $navbar-height\n &.has-navbar-fixed-bottom\n padding-bottom: $navbar-height\n\n.navbar-brand,\n.navbar-tabs\n align-items: stretch\n display: flex\n flex-shrink: 0\n min-height: $navbar-height\n\n.navbar-brand\n a.navbar-item\n &:focus,\n &:hover\n background-color: transparent\n\n.navbar-tabs\n +overflow-touch\n max-width: 100vw\n overflow-x: auto\n overflow-y: hidden\n\n.navbar-burger\n @extend %reset\n color: $navbar-burger-color\n +hamburger($navbar-height)\n +ltr-property(\"margin\", auto, false)\n\n.navbar-menu\n display: none\n\n.navbar-item,\n.navbar-link\n color: $navbar-item-color\n display: block\n line-height: 1.5\n padding: 0.5rem 0.75rem\n position: relative\n .icon\n &:only-child\n margin-left: -0.25rem\n margin-right: -0.25rem\n\na.navbar-item,\n.navbar-link\n cursor: pointer\n &:focus,\n &:focus-within,\n &:hover,\n &.is-active\n background-color: $navbar-item-hover-background-color\n color: $navbar-item-hover-color\n\n.navbar-item\n flex-grow: 0\n flex-shrink: 0\n img\n max-height: $navbar-item-img-max-height\n &.has-dropdown\n padding: 0\n &.is-expanded\n flex-grow: 1\n flex-shrink: 1\n &.is-tab\n border-bottom: 1px solid transparent\n min-height: $navbar-height\n padding-bottom: calc(0.5rem - 1px)\n &:focus,\n &:hover\n background-color: $navbar-tab-hover-background-color\n border-bottom-color: $navbar-tab-hover-border-bottom-color\n &.is-active\n background-color: $navbar-tab-active-background-color\n border-bottom-color: $navbar-tab-active-border-bottom-color\n border-bottom-style: $navbar-tab-active-border-bottom-style\n border-bottom-width: $navbar-tab-active-border-bottom-width\n color: $navbar-tab-active-color\n padding-bottom: calc(0.5rem - #{$navbar-tab-active-border-bottom-width})\n\n.navbar-content\n flex-grow: 1\n flex-shrink: 1\n\n.navbar-link:not(.is-arrowless)\n +ltr-property(\"padding\", 2.5em)\n &::after\n @extend %arrow\n border-color: $navbar-dropdown-arrow\n margin-top: -0.375em\n +ltr-position(1.125em)\n\n.navbar-dropdown\n font-size: 0.875rem\n padding-bottom: 0.5rem\n padding-top: 0.5rem\n .navbar-item\n padding-left: 1.5rem\n padding-right: 1.5rem\n\n.navbar-divider\n background-color: $navbar-divider-background-color\n border: none\n display: none\n height: $navbar-divider-height\n margin: 0.5rem 0\n\n+until($navbar-breakpoint)\n .navbar > .container\n display: block\n .navbar-brand,\n .navbar-tabs\n .navbar-item\n align-items: center\n display: flex\n .navbar-link\n &::after\n display: none\n .navbar-menu\n background-color: $navbar-background-color\n box-shadow: 0 8px 16px bulmaRgba($scheme-invert, 0.1)\n padding: 0.5rem 0\n &.is-active\n display: block\n // Fixed navbar\n .navbar\n &.is-fixed-bottom-touch,\n &.is-fixed-top-touch\n +navbar-fixed\n &.is-fixed-bottom-touch\n bottom: 0\n &.has-shadow\n box-shadow: 0 -2px 3px bulmaRgba($scheme-invert, 0.1)\n &.is-fixed-top-touch\n top: 0\n &.is-fixed-top,\n &.is-fixed-top-touch\n .navbar-menu\n +overflow-touch\n max-height: calc(100vh - #{$navbar-height})\n overflow: auto\n html,\n body\n &.has-navbar-fixed-top-touch\n padding-top: $navbar-height\n &.has-navbar-fixed-bottom-touch\n padding-bottom: $navbar-height\n\n+from($navbar-breakpoint)\n .navbar,\n .navbar-menu,\n .navbar-start,\n .navbar-end\n align-items: stretch\n display: flex\n .navbar\n min-height: $navbar-height\n &.is-spaced\n padding: $navbar-padding-vertical $navbar-padding-horizontal\n .navbar-start,\n .navbar-end\n align-items: center\n a.navbar-item,\n .navbar-link\n border-radius: $radius\n &.is-transparent\n a.navbar-item,\n .navbar-link\n &:focus,\n &:hover,\n &.is-active\n background-color: transparent !important\n .navbar-item.has-dropdown\n &.is-active,\n &.is-hoverable:focus,\n &.is-hoverable:focus-within,\n &.is-hoverable:hover\n .navbar-link\n background-color: transparent !important\n .navbar-dropdown\n a.navbar-item\n &:focus,\n &:hover\n background-color: $navbar-dropdown-item-hover-background-color\n color: $navbar-dropdown-item-hover-color\n &.is-active\n background-color: $navbar-dropdown-item-active-background-color\n color: $navbar-dropdown-item-active-color\n .navbar-burger\n display: none\n .navbar-item,\n .navbar-link\n align-items: center\n display: flex\n .navbar-item\n &.has-dropdown\n align-items: stretch\n &.has-dropdown-up\n .navbar-link::after\n transform: rotate(135deg) translate(0.25em, -0.25em)\n .navbar-dropdown\n border-bottom: $navbar-dropdown-border-top\n border-radius: $navbar-dropdown-radius $navbar-dropdown-radius 0 0\n border-top: none\n bottom: 100%\n box-shadow: 0 -8px 8px bulmaRgba($scheme-invert, 0.1)\n top: auto\n &.is-active,\n &.is-hoverable:focus,\n &.is-hoverable:focus-within,\n &.is-hoverable:hover\n .navbar-dropdown\n display: block\n .navbar.is-spaced &,\n &.is-boxed\n opacity: 1\n pointer-events: auto\n transform: translateY(0)\n .navbar-menu\n flex-grow: 1\n flex-shrink: 0\n .navbar-start\n justify-content: flex-start\n +ltr-property(\"margin\", auto)\n .navbar-end\n justify-content: flex-end\n +ltr-property(\"margin\", auto, false)\n .navbar-dropdown\n background-color: $navbar-dropdown-background-color\n border-bottom-left-radius: $navbar-dropdown-radius\n border-bottom-right-radius: $navbar-dropdown-radius\n border-top: $navbar-dropdown-border-top\n box-shadow: 0 8px 8px bulmaRgba($scheme-invert, 0.1)\n display: none\n font-size: 0.875rem\n +ltr-position(0, false)\n min-width: 100%\n position: absolute\n top: 100%\n z-index: $navbar-dropdown-z\n .navbar-item\n padding: 0.375rem 1rem\n white-space: nowrap\n a.navbar-item\n +ltr-property(\"padding\", 3rem)\n &:focus,\n &:hover\n background-color: $navbar-dropdown-item-hover-background-color\n color: $navbar-dropdown-item-hover-color\n &.is-active\n background-color: $navbar-dropdown-item-active-background-color\n color: $navbar-dropdown-item-active-color\n .navbar.is-spaced &,\n &.is-boxed\n border-radius: $navbar-dropdown-boxed-radius\n border-top: none\n box-shadow: $navbar-dropdown-boxed-shadow\n display: block\n opacity: 0\n pointer-events: none\n top: calc(100% + (#{$navbar-dropdown-offset}))\n transform: translateY(-5px)\n transition-duration: $speed\n transition-property: opacity, transform\n &.is-right\n left: auto\n right: 0\n .navbar-divider\n display: block\n .navbar > .container,\n .container > .navbar\n .navbar-brand\n +ltr-property(\"margin\", -.75rem, false)\n .navbar-menu\n +ltr-property(\"margin\", -.75rem)\n // Fixed navbar\n .navbar\n &.is-fixed-bottom-desktop,\n &.is-fixed-top-desktop\n +navbar-fixed\n &.is-fixed-bottom-desktop\n bottom: 0\n &.has-shadow\n box-shadow: 0 -2px 3px bulmaRgba($scheme-invert, 0.1)\n &.is-fixed-top-desktop\n top: 0\n html,\n body\n &.has-navbar-fixed-top-desktop\n padding-top: $navbar-height\n &.has-navbar-fixed-bottom-desktop\n padding-bottom: $navbar-height\n &.has-spaced-navbar-fixed-top\n padding-top: $navbar-height + ($navbar-padding-vertical * 2)\n &.has-spaced-navbar-fixed-bottom\n padding-bottom: $navbar-height + ($navbar-padding-vertical * 2)\n // Hover/Active states\n a.navbar-item,\n .navbar-link\n &.is-active\n color: $navbar-item-active-color\n &.is-active:not(:focus):not(:hover)\n background-color: $navbar-item-active-background-color\n .navbar-item.has-dropdown\n &:focus,\n &:hover,\n &.is-active\n .navbar-link\n background-color: $navbar-item-hover-background-color\n\n// Combination\n\n.hero\n &.is-fullheight-with-navbar\n min-height: calc(100vh - #{$navbar-height})\n" }, { "path": "guide/style/bulma/sass/components/pagination.sass", "content": "@import \"../utilities/controls\"\n@import \"../utilities/mixins\"\n\n$pagination-color: $text-strong !default\n$pagination-border-color: $border !default\n$pagination-margin: -0.25rem !default\n$pagination-min-width: $control-height !default\n\n$pagination-item-font-size: 1em !default\n$pagination-item-margin: 0.25rem !default\n$pagination-item-padding-left: 0.5em !default\n$pagination-item-padding-right: 0.5em !default\n\n$pagination-nav-padding-left: 0.75em !default\n$pagination-nav-padding-right: 0.75em !default\n\n$pagination-hover-color: $link-hover !default\n$pagination-hover-border-color: $link-hover-border !default\n\n$pagination-focus-color: $link-focus !default\n$pagination-focus-border-color: $link-focus-border !default\n\n$pagination-active-color: $link-active !default\n$pagination-active-border-color: $link-active-border !default\n\n$pagination-disabled-color: $text-light !default\n$pagination-disabled-background-color: $border !default\n$pagination-disabled-border-color: $border !default\n\n$pagination-current-color: $link-invert !default\n$pagination-current-background-color: $link !default\n$pagination-current-border-color: $link !default\n\n$pagination-ellipsis-color: $grey-light !default\n\n$pagination-shadow-inset: inset 0 1px 2px rgba($scheme-invert, 0.2) !default\n\n.pagination\n @extend %block\n font-size: $size-normal\n margin: $pagination-margin\n // Sizes\n &.is-small\n font-size: $size-small\n &.is-medium\n font-size: $size-medium\n &.is-large\n font-size: $size-large\n &.is-rounded\n .pagination-previous,\n .pagination-next\n padding-left: 1em\n padding-right: 1em\n border-radius: $radius-rounded\n .pagination-link\n border-radius: $radius-rounded\n\n.pagination,\n.pagination-list\n align-items: center\n display: flex\n justify-content: center\n text-align: center\n\n.pagination-previous,\n.pagination-next,\n.pagination-link,\n.pagination-ellipsis\n @extend %control\n @extend %unselectable\n font-size: $pagination-item-font-size\n justify-content: center\n margin: $pagination-item-margin\n padding-left: $pagination-item-padding-left\n padding-right: $pagination-item-padding-right\n text-align: center\n\n.pagination-previous,\n.pagination-next,\n.pagination-link\n border-color: $pagination-border-color\n color: $pagination-color\n min-width: $pagination-min-width\n &:hover\n border-color: $pagination-hover-border-color\n color: $pagination-hover-color\n &:focus\n border-color: $pagination-focus-border-color\n &:active\n box-shadow: $pagination-shadow-inset\n &[disabled],\n &.is-disabled\n background-color: $pagination-disabled-background-color\n border-color: $pagination-disabled-border-color\n box-shadow: none\n color: $pagination-disabled-color\n opacity: 0.5\n\n.pagination-previous,\n.pagination-next\n padding-left: $pagination-nav-padding-left\n padding-right: $pagination-nav-padding-right\n white-space: nowrap\n\n.pagination-link\n &.is-current\n background-color: $pagination-current-background-color\n border-color: $pagination-current-border-color\n color: $pagination-current-color\n\n.pagination-ellipsis\n color: $pagination-ellipsis-color\n pointer-events: none\n\n.pagination-list\n flex-wrap: wrap\n li\n list-style: none\n\n+mobile\n .pagination\n flex-wrap: wrap\n .pagination-previous,\n .pagination-next\n flex-grow: 1\n flex-shrink: 1\n .pagination-list\n li\n flex-grow: 1\n flex-shrink: 1\n\n+tablet\n .pagination-list\n flex-grow: 1\n flex-shrink: 1\n justify-content: flex-start\n order: 1\n .pagination-previous,\n .pagination-next,\n .pagination-link,\n .pagination-ellipsis\n margin-bottom: 0\n margin-top: 0\n .pagination-previous\n order: 2\n .pagination-next\n order: 3\n .pagination\n justify-content: space-between\n margin-bottom: 0\n margin-top: 0\n &.is-centered\n .pagination-previous\n order: 1\n .pagination-list\n justify-content: center\n order: 2\n .pagination-next\n order: 3\n &.is-right\n .pagination-previous\n order: 1\n .pagination-next\n order: 2\n .pagination-list\n justify-content: flex-end\n order: 3\n" }, { "path": "guide/style/bulma/sass/components/panel.sass", "content": "@import \"../utilities/mixins\"\n\n$panel-margin: $block-spacing !default\n$panel-item-border: 1px solid $border-light !default\n$panel-radius: $radius-large !default\n$panel-shadow: $shadow !default\n\n$panel-heading-background-color: $border-light !default\n$panel-heading-color: $text-strong !default\n$panel-heading-line-height: 1.25 !default\n$panel-heading-padding: 0.75em 1em !default\n$panel-heading-radius: $radius !default\n$panel-heading-size: 1.25em !default\n$panel-heading-weight: $weight-bold !default\n\n$panel-tabs-font-size: 0.875em !default\n$panel-tab-border-bottom: 1px solid $border !default\n$panel-tab-active-border-bottom-color: $link-active-border !default\n$panel-tab-active-color: $link-active !default\n\n$panel-list-item-color: $text !default\n$panel-list-item-hover-color: $link !default\n\n$panel-block-color: $text-strong !default\n$panel-block-hover-background-color: $background !default\n$panel-block-active-border-left-color: $link !default\n$panel-block-active-color: $link-active !default\n$panel-block-active-icon-color: $link !default\n\n$panel-icon-color: $text-light !default\n$panel-colors: $colors !default\n\n.panel\n border-radius: $panel-radius\n box-shadow: $panel-shadow\n font-size: $size-normal\n &:not(:last-child)\n margin-bottom: $panel-margin\n // Colors\n @each $name, $components in $panel-colors\n $color: nth($components, 1)\n $color-invert: nth($components, 2)\n &.is-#{$name}\n .panel-heading\n background-color: $color\n color: $color-invert\n .panel-tabs a.is-active\n border-bottom-color: $color\n .panel-block.is-active .panel-icon\n color: $color\n\n.panel-tabs,\n.panel-block\n &:not(:last-child)\n border-bottom: $panel-item-border\n\n.panel-heading\n background-color: $panel-heading-background-color\n border-radius: $panel-radius $panel-radius 0 0\n color: $panel-heading-color\n font-size: $panel-heading-size\n font-weight: $panel-heading-weight\n line-height: $panel-heading-line-height\n padding: $panel-heading-padding\n\n.panel-tabs\n align-items: flex-end\n display: flex\n font-size: $panel-tabs-font-size\n justify-content: center\n a\n border-bottom: $panel-tab-border-bottom\n margin-bottom: -1px\n padding: 0.5em\n // Modifiers\n &.is-active\n border-bottom-color: $panel-tab-active-border-bottom-color\n color: $panel-tab-active-color\n\n.panel-list\n a\n color: $panel-list-item-color\n &:hover\n color: $panel-list-item-hover-color\n\n.panel-block\n align-items: center\n color: $panel-block-color\n display: flex\n justify-content: flex-start\n padding: 0.5em 0.75em\n input[type=\"checkbox\"]\n +ltr-property(\"margin\", 0.75em)\n & > .control\n flex-grow: 1\n flex-shrink: 1\n width: 100%\n &.is-wrapped\n flex-wrap: wrap\n &.is-active\n border-left-color: $panel-block-active-border-left-color\n color: $panel-block-active-color\n .panel-icon\n color: $panel-block-active-icon-color\n &:last-child\n border-bottom-left-radius: $panel-radius\n border-bottom-right-radius: $panel-radius\n\na.panel-block,\nlabel.panel-block\n cursor: pointer\n &:hover\n background-color: $panel-block-hover-background-color\n\n.panel-icon\n +fa(14px, 1em)\n color: $panel-icon-color\n +ltr-property(\"margin\", 0.75em)\n .fa\n font-size: inherit\n line-height: inherit\n" }, { "path": "guide/style/bulma/sass/components/tabs.sass", "content": "@import \"../utilities/mixins\"\n\n$tabs-border-bottom-color: $border !default\n$tabs-border-bottom-style: solid !default\n$tabs-border-bottom-width: 1px !default\n$tabs-link-color: $text !default\n$tabs-link-hover-border-bottom-color: $text-strong !default\n$tabs-link-hover-color: $text-strong !default\n$tabs-link-active-border-bottom-color: $link !default\n$tabs-link-active-color: $link !default\n$tabs-link-padding: 0.5em 1em !default\n\n$tabs-boxed-link-radius: $radius !default\n$tabs-boxed-link-hover-background-color: $background !default\n$tabs-boxed-link-hover-border-bottom-color: $border !default\n\n$tabs-boxed-link-active-background-color: $scheme-main !default\n$tabs-boxed-link-active-border-color: $border !default\n$tabs-boxed-link-active-border-bottom-color: transparent !default\n\n$tabs-toggle-link-border-color: $border !default\n$tabs-toggle-link-border-style: solid !default\n$tabs-toggle-link-border-width: 1px !default\n$tabs-toggle-link-hover-background-color: $background !default\n$tabs-toggle-link-hover-border-color: $border-hover !default\n$tabs-toggle-link-radius: $radius !default\n$tabs-toggle-link-active-background-color: $link !default\n$tabs-toggle-link-active-border-color: $link !default\n$tabs-toggle-link-active-color: $link-invert !default\n\n.tabs\n @extend %block\n +overflow-touch\n @extend %unselectable\n align-items: stretch\n display: flex\n font-size: $size-normal\n justify-content: space-between\n overflow: hidden\n overflow-x: auto\n white-space: nowrap\n a\n align-items: center\n border-bottom-color: $tabs-border-bottom-color\n border-bottom-style: $tabs-border-bottom-style\n border-bottom-width: $tabs-border-bottom-width\n color: $tabs-link-color\n display: flex\n justify-content: center\n margin-bottom: -#{$tabs-border-bottom-width}\n padding: $tabs-link-padding\n vertical-align: top\n &:hover\n border-bottom-color: $tabs-link-hover-border-bottom-color\n color: $tabs-link-hover-color\n li\n display: block\n &.is-active\n a\n border-bottom-color: $tabs-link-active-border-bottom-color\n color: $tabs-link-active-color\n ul\n align-items: center\n border-bottom-color: $tabs-border-bottom-color\n border-bottom-style: $tabs-border-bottom-style\n border-bottom-width: $tabs-border-bottom-width\n display: flex\n flex-grow: 1\n flex-shrink: 0\n justify-content: flex-start\n &.is-left\n padding-right: 0.75em\n &.is-center\n flex: none\n justify-content: center\n padding-left: 0.75em\n padding-right: 0.75em\n &.is-right\n justify-content: flex-end\n padding-left: 0.75em\n .icon\n &:first-child\n +ltr-property(\"margin\", 0.5em)\n &:last-child\n +ltr-property(\"margin\", 0.5em, false)\n // Alignment\n &.is-centered\n ul\n justify-content: center\n &.is-right\n ul\n justify-content: flex-end\n // Styles\n &.is-boxed\n a\n border: 1px solid transparent\n +ltr\n border-radius: $tabs-boxed-link-radius $tabs-boxed-link-radius 0 0\n +rtl\n border-radius: 0 0 $tabs-boxed-link-radius $tabs-boxed-link-radius\n &:hover\n background-color: $tabs-boxed-link-hover-background-color\n border-bottom-color: $tabs-boxed-link-hover-border-bottom-color\n li\n &.is-active\n a\n background-color: $tabs-boxed-link-active-background-color\n border-color: $tabs-boxed-link-active-border-color\n border-bottom-color: $tabs-boxed-link-active-border-bottom-color !important\n &.is-fullwidth\n li\n flex-grow: 1\n flex-shrink: 0\n &.is-toggle\n a\n border-color: $tabs-toggle-link-border-color\n border-style: $tabs-toggle-link-border-style\n border-width: $tabs-toggle-link-border-width\n margin-bottom: 0\n position: relative\n &:hover\n background-color: $tabs-toggle-link-hover-background-color\n border-color: $tabs-toggle-link-hover-border-color\n z-index: 2\n li\n & + li\n +ltr-property(\"margin\", -#{$tabs-toggle-link-border-width}, false)\n &:first-child a\n +ltr\n border-top-left-radius: $tabs-toggle-link-radius\n border-bottom-left-radius: $tabs-toggle-link-radius\n +rtl\n border-top-right-radius: $tabs-toggle-link-radius\n border-bottom-right-radius: $tabs-toggle-link-radius\n &:last-child a\n +ltr\n border-top-right-radius: $tabs-toggle-link-radius\n border-bottom-right-radius: $tabs-toggle-link-radius\n +rtl\n border-top-left-radius: $tabs-toggle-link-radius\n border-bottom-left-radius: $tabs-toggle-link-radius\n &.is-active\n a\n background-color: $tabs-toggle-link-active-background-color\n border-color: $tabs-toggle-link-active-border-color\n color: $tabs-toggle-link-active-color\n z-index: 1\n ul\n border-bottom: none\n &.is-toggle-rounded\n li\n &:first-child a\n +ltr\n border-bottom-left-radius: $radius-rounded\n border-top-left-radius: $radius-rounded\n padding-left: 1.25em\n +rtl\n border-bottom-right-radius: $radius-rounded\n border-top-right-radius: $radius-rounded\n padding-right: 1.25em\n &:last-child a\n +ltr\n border-bottom-right-radius: $radius-rounded\n border-top-right-radius: $radius-rounded\n padding-right: 1.25em\n +rtl\n border-bottom-left-radius: $radius-rounded\n border-top-left-radius: $radius-rounded\n padding-left: 1.25em\n // Sizes\n &.is-small\n font-size: $size-small\n &.is-medium\n font-size: $size-medium\n &.is-large\n font-size: $size-large\n" }, { "path": "guide/style/bulma/sass/elements/_all.sass", "content": "/* Bulma Elements */\n@charset \"utf-8\"\n\n@import \"box\"\n@import \"button\"\n@import \"container\"\n@import \"content\"\n@import \"icon\"\n@import \"image\"\n@import \"notification\"\n@import \"progress\"\n@import \"table\"\n@import \"tag\"\n@import \"title\"\n\n@import \"other\"\n" }, { "path": "guide/style/bulma/sass/elements/box.sass", "content": "@import \"../utilities/mixins\"\n\n$box-color: $text !default\n$box-background-color: $scheme-main !default\n$box-radius: $radius-large !default\n$box-shadow: $shadow !default\n$box-padding: 1.25rem !default\n\n$box-link-hover-shadow: 0 0.5em 1em -0.125em rgba($scheme-invert, 0.1), 0 0 0 1px $link !default\n$box-link-active-shadow: inset 0 1px 2px rgba($scheme-invert, 0.2), 0 0 0 1px $link !default\n\n.box\n @extend %block\n background-color: $box-background-color\n border-radius: $box-radius\n box-shadow: $box-shadow\n color: $box-color\n display: block\n padding: $box-padding\n\na.box\n &:hover,\n &:focus\n box-shadow: $box-link-hover-shadow\n &:active\n box-shadow: $box-link-active-shadow\n" }, { "path": "guide/style/bulma/sass/elements/button.sass", "content": "@import \"../utilities/controls\"\n@import \"../utilities/mixins\"\n\n$button-color: $text-strong !default\n$button-background-color: $scheme-main !default\n$button-family: false !default\n\n$button-border-color: $border !default\n$button-border-width: $control-border-width !default\n\n$button-padding-vertical: calc(0.5em - #{$button-border-width}) !default\n$button-padding-horizontal: 1em !default\n\n$button-hover-color: $link-hover !default\n$button-hover-border-color: $link-hover-border !default\n\n$button-focus-color: $link-focus !default\n$button-focus-border-color: $link-focus-border !default\n$button-focus-box-shadow-size: 0 0 0 0.125em !default\n$button-focus-box-shadow-color: bulmaRgba($link, 0.25) !default\n\n$button-active-color: $link-active !default\n$button-active-border-color: $link-active-border !default\n\n$button-text-color: $text !default\n$button-text-decoration: underline !default\n$button-text-hover-background-color: $background !default\n$button-text-hover-color: $text-strong !default\n\n$button-ghost-background: none !default\n$button-ghost-border-color: transparent !default\n$button-ghost-color: $link !default\n$button-ghost-decoration: none !default\n$button-ghost-hover-color: $link !default\n$button-ghost-hover-decoration: underline !default\n\n$button-disabled-background-color: $scheme-main !default\n$button-disabled-border-color: $border !default\n$button-disabled-shadow: none !default\n$button-disabled-opacity: 0.5 !default\n\n$button-static-color: $text-light !default\n$button-static-background-color: $scheme-main-ter !default\n$button-static-border-color: $border !default\n\n$button-colors: $colors !default\n$button-responsive-sizes: (\"mobile\": (\"small\": ($size-small * 0.75), \"normal\": ($size-small * 0.875), \"medium\": $size-small, \"large\": $size-normal), \"tablet-only\": (\"small\": ($size-small * 0.875), \"normal\": ($size-small), \"medium\": $size-normal, \"large\": $size-medium)) !default\n\n// The button sizes use mixins so they can be used at different breakpoints\n=button-small\n &:not(.is-rounded)\n border-radius: $radius-small\n font-size: $size-small\n=button-normal\n font-size: $size-normal\n=button-medium\n font-size: $size-medium\n=button-large\n font-size: $size-large\n\n.button\n @extend %control\n @extend %unselectable\n background-color: $button-background-color\n border-color: $button-border-color\n border-width: $button-border-width\n color: $button-color\n cursor: pointer\n @if $button-family\n font-family: $button-family\n justify-content: center\n padding-bottom: $button-padding-vertical\n padding-left: $button-padding-horizontal\n padding-right: $button-padding-horizontal\n padding-top: $button-padding-vertical\n text-align: center\n white-space: nowrap\n strong\n color: inherit\n .icon\n &,\n &.is-small,\n &.is-medium,\n &.is-large\n height: 1.5em\n width: 1.5em\n &:first-child:not(:last-child)\n +ltr-property(\"margin\", calc(#{-0.5 * $button-padding-horizontal} - #{$button-border-width}), false)\n +ltr-property(\"margin\", $button-padding-horizontal * 0.25)\n &:last-child:not(:first-child)\n +ltr-property(\"margin\", $button-padding-horizontal * 0.25, false)\n +ltr-property(\"margin\", calc(#{-0.5 * $button-padding-horizontal} - #{$button-border-width}))\n &:first-child:last-child\n margin-left: calc(#{-0.5 * $button-padding-horizontal} - #{$button-border-width})\n margin-right: calc(#{-0.5 * $button-padding-horizontal} - #{$button-border-width})\n // States\n &:hover,\n &.is-hovered\n border-color: $button-hover-border-color\n color: $button-hover-color\n &:focus,\n &.is-focused\n border-color: $button-focus-border-color\n color: $button-focus-color\n &:not(:active)\n box-shadow: $button-focus-box-shadow-size $button-focus-box-shadow-color\n &:active,\n &.is-active\n border-color: $button-active-border-color\n color: $button-active-color\n // Colors\n &.is-text\n background-color: transparent\n border-color: transparent\n color: $button-text-color\n text-decoration: $button-text-decoration\n &:hover,\n &.is-hovered,\n &:focus,\n &.is-focused\n background-color: $button-text-hover-background-color\n color: $button-text-hover-color\n &:active,\n &.is-active\n background-color: bulmaDarken($button-text-hover-background-color, 5%)\n color: $button-text-hover-color\n &[disabled],\n fieldset[disabled] &\n background-color: transparent\n border-color: transparent\n box-shadow: none\n &.is-ghost\n background: $button-ghost-background\n border-color: $button-ghost-border-color\n color: $button-ghost-color\n text-decoration: $button-ghost-decoration\n &:hover,\n &.is-hovered\n color: $button-ghost-hover-color\n text-decoration: $button-ghost-hover-decoration\n @each $name, $pair in $button-colors\n $color: nth($pair, 1)\n $color-invert: nth($pair, 2)\n &.is-#{$name}\n background-color: $color\n border-color: transparent\n color: $color-invert\n &:hover,\n &.is-hovered\n background-color: bulmaDarken($color, 2.5%)\n border-color: transparent\n color: $color-invert\n &:focus,\n &.is-focused\n border-color: transparent\n color: $color-invert\n &:not(:active)\n box-shadow: $button-focus-box-shadow-size bulmaRgba($color, 0.25)\n &:active,\n &.is-active\n background-color: bulmaDarken($color, 5%)\n border-color: transparent\n color: $color-invert\n &[disabled],\n fieldset[disabled] &\n background-color: $color\n border-color: $color\n box-shadow: none\n &.is-inverted\n background-color: $color-invert\n color: $color\n &:hover,\n &.is-hovered\n background-color: bulmaDarken($color-invert, 5%)\n &[disabled],\n fieldset[disabled] &\n background-color: $color-invert\n border-color: transparent\n box-shadow: none\n color: $color\n &.is-loading\n &::after\n border-color: transparent transparent $color-invert $color-invert !important\n &.is-outlined\n background-color: transparent\n border-color: $color\n color: $color\n &:hover,\n &.is-hovered,\n &:focus,\n &.is-focused\n background-color: $color\n border-color: $color\n color: $color-invert\n &.is-loading\n &::after\n border-color: transparent transparent $color $color !important\n &:hover,\n &.is-hovered,\n &:focus,\n &.is-focused\n &::after\n border-color: transparent transparent $color-invert $color-invert !important\n &[disabled],\n fieldset[disabled] &\n background-color: transparent\n border-color: $color\n box-shadow: none\n color: $color\n &.is-inverted.is-outlined\n background-color: transparent\n border-color: $color-invert\n color: $color-invert\n &:hover,\n &.is-hovered,\n &:focus,\n &.is-focused\n background-color: $color-invert\n color: $color\n &.is-loading\n &:hover,\n &.is-hovered,\n &:focus,\n &.is-focused\n &::after\n border-color: transparent transparent $color $color !important\n &[disabled],\n fieldset[disabled] &\n background-color: transparent\n border-color: $color-invert\n box-shadow: none\n color: $color-invert\n // If light and dark colors are provided\n @if length($pair) >= 4\n $color-light: nth($pair, 3)\n $color-dark: nth($pair, 4)\n &.is-light\n background-color: $color-light\n color: $color-dark\n &:hover,\n &.is-hovered\n background-color: bulmaDarken($color-light, 2.5%)\n border-color: transparent\n color: $color-dark\n &:active,\n &.is-active\n background-color: bulmaDarken($color-light, 5%)\n border-color: transparent\n color: $color-dark\n // Sizes\n &.is-small\n +button-small\n &.is-normal\n +button-normal\n &.is-medium\n +button-medium\n &.is-large\n +button-large\n // Modifiers\n &[disabled],\n fieldset[disabled] &\n background-color: $button-disabled-background-color\n border-color: $button-disabled-border-color\n box-shadow: $button-disabled-shadow\n opacity: $button-disabled-opacity\n &.is-fullwidth\n display: flex\n width: 100%\n &.is-loading\n color: transparent !important\n pointer-events: none\n &::after\n @extend %loader\n +center(1em)\n position: absolute !important\n &.is-static\n background-color: $button-static-background-color\n border-color: $button-static-border-color\n color: $button-static-color\n box-shadow: none\n pointer-events: none\n &.is-rounded\n border-radius: $radius-rounded\n padding-left: calc(#{$button-padding-horizontal} + 0.25em)\n padding-right: calc(#{$button-padding-horizontal} + 0.25em)\n\n.buttons\n align-items: center\n display: flex\n flex-wrap: wrap\n justify-content: flex-start\n .button\n margin-bottom: 0.5rem\n &:not(:last-child):not(.is-fullwidth)\n +ltr-property(\"margin\", 0.5rem)\n &:last-child\n margin-bottom: -0.5rem\n &:not(:last-child)\n margin-bottom: 1rem\n // Sizes\n &.are-small\n .button:not(.is-normal):not(.is-medium):not(.is-large)\n +button-small\n &.are-medium\n .button:not(.is-small):not(.is-normal):not(.is-large)\n +button-medium\n &.are-large\n .button:not(.is-small):not(.is-normal):not(.is-medium)\n +button-large\n &.has-addons\n .button\n &:not(:first-child)\n border-bottom-left-radius: 0\n border-top-left-radius: 0\n &:not(:last-child)\n border-bottom-right-radius: 0\n border-top-right-radius: 0\n +ltr-property(\"margin\", -1px)\n &:last-child\n +ltr-property(\"margin\", 0)\n &:hover,\n &.is-hovered\n z-index: 2\n &:focus,\n &.is-focused,\n &:active,\n &.is-active,\n &.is-selected\n z-index: 3\n &:hover\n z-index: 4\n &.is-expanded\n flex-grow: 1\n flex-shrink: 1\n &.is-centered\n justify-content: center\n &:not(.has-addons)\n .button:not(.is-fullwidth)\n margin-left: 0.25rem\n margin-right: 0.25rem\n &.is-right\n justify-content: flex-end\n &:not(.has-addons)\n .button:not(.is-fullwidth)\n margin-left: 0.25rem\n margin-right: 0.25rem\n\n@each $bp-name, $bp-sizes in $button-responsive-sizes\n +breakpoint($bp-name)\n @each $size, $value in $bp-sizes\n @if $size != \"normal\"\n .button.is-responsive.is-#{$size}\n font-size: $value\n @else\n .button.is-responsive,\n .button.is-responsive.is-normal\n font-size: $value\n" }, { "path": "guide/style/bulma/sass/elements/container.sass", "content": "@import \"../utilities/mixins\"\n\n$container-offset: (2 * $gap) !default\n$container-max-width: $fullhd !default\n\n.container\n flex-grow: 1\n margin: 0 auto\n position: relative\n width: auto\n &.is-fluid\n max-width: none !important\n padding-left: $gap\n padding-right: $gap\n width: 100%\n +desktop\n max-width: $desktop - $container-offset\n +until-widescreen\n &.is-widescreen:not(.is-max-desktop)\n max-width: min($widescreen, $container-max-width) - $container-offset\n +until-fullhd\n &.is-fullhd:not(.is-max-desktop):not(.is-max-widescreen)\n max-width: min($fullhd, $container-max-width) - $container-offset\n +widescreen\n &:not(.is-max-desktop)\n max-width: min($widescreen, $container-max-width) - $container-offset\n +fullhd\n &:not(.is-max-desktop):not(.is-max-widescreen)\n max-width: min($fullhd, $container-max-width) - $container-offset\n" }, { "path": "guide/style/bulma/sass/elements/content.sass", "content": "@import \"../utilities/mixins\"\n\n$content-heading-color: $text-strong !default\n$content-heading-weight: $weight-semibold !default\n$content-heading-line-height: 1.125 !default\n\n$content-block-margin-bottom: 1em !default\n\n$content-blockquote-background-color: $background !default\n$content-blockquote-border-left: 5px solid $border !default\n$content-blockquote-padding: 1.25em 1.5em !default\n\n$content-pre-padding: 1.25em 1.5em !default\n\n$content-table-cell-border: 1px solid $border !default\n$content-table-cell-border-width: 0 0 1px !default\n$content-table-cell-padding: 0.5em 0.75em !default\n$content-table-cell-heading-color: $text-strong !default\n$content-table-head-cell-border-width: 0 0 2px !default\n$content-table-head-cell-color: $text-strong !default\n$content-table-body-last-row-cell-border-bottom-width: 0 !default\n$content-table-foot-cell-border-width: 2px 0 0 !default\n$content-table-foot-cell-color: $text-strong !default\n\n.content\n @extend %block\n // Inline\n li + li\n margin-top: 0.25em\n // Block\n p,\n dl,\n ol,\n ul,\n blockquote,\n pre,\n table\n &:not(:last-child)\n margin-bottom: $content-block-margin-bottom\n h1,\n h2,\n h3,\n h4,\n h5,\n h6\n color: $content-heading-color\n font-weight: $content-heading-weight\n line-height: $content-heading-line-height\n h1\n font-size: 2em\n margin-bottom: 0.5em\n &:not(:first-child)\n margin-top: 1em\n h2\n font-size: 1.75em\n margin-bottom: 0.5714em\n &:not(:first-child)\n margin-top: 1.1428em\n h3\n font-size: 1.5em\n margin-bottom: 0.6666em\n &:not(:first-child)\n margin-top: 1.3333em\n h4\n font-size: 1.25em\n margin-bottom: 0.8em\n h5\n font-size: 1.125em\n margin-bottom: 0.8888em\n h6\n font-size: 1em\n margin-bottom: 1em\n blockquote\n background-color: $content-blockquote-background-color\n +ltr-property(\"border\", $content-blockquote-border-left, false)\n padding: $content-blockquote-padding\n ol\n list-style-position: outside\n +ltr-property(\"margin\", 2em, false)\n margin-top: 1em\n &:not([type])\n list-style-type: decimal\n &.is-lower-alpha\n list-style-type: lower-alpha\n &.is-lower-roman\n list-style-type: lower-roman\n &.is-upper-alpha\n list-style-type: upper-alpha\n &.is-upper-roman\n list-style-type: upper-roman\n ul\n list-style: disc outside\n +ltr-property(\"margin\", 2em, false)\n margin-top: 1em\n ul\n list-style-type: circle\n margin-top: 0.5em\n ul\n list-style-type: square\n dd\n +ltr-property(\"margin\", 2em, false)\n figure\n margin-left: 2em\n margin-right: 2em\n text-align: center\n &:not(:first-child)\n margin-top: 2em\n &:not(:last-child)\n margin-bottom: 2em\n img\n display: inline-block\n figcaption\n font-style: italic\n pre\n +overflow-touch\n overflow-x: auto\n padding: $content-pre-padding\n white-space: pre\n word-wrap: normal\n sup,\n sub\n font-size: 75%\n table\n width: 100%\n td,\n th\n border: $content-table-cell-border\n border-width: $content-table-cell-border-width\n padding: $content-table-cell-padding\n vertical-align: top\n th\n color: $content-table-cell-heading-color\n &:not([align])\n text-align: inherit\n thead\n td,\n th\n border-width: $content-table-head-cell-border-width\n color: $content-table-head-cell-color\n tfoot\n td,\n th\n border-width: $content-table-foot-cell-border-width\n color: $content-table-foot-cell-color\n tbody\n tr\n &:last-child\n td,\n th\n border-bottom-width: $content-table-body-last-row-cell-border-bottom-width\n .tabs\n li + li\n margin-top: 0\n // Sizes\n &.is-small\n font-size: $size-small\n &.is-normal\n font-size: $size-normal\n &.is-medium\n font-size: $size-medium\n &.is-large\n font-size: $size-large\n" }, { "path": "guide/style/bulma/sass/elements/form.sass", "content": "@warn \"The form.sass file is DEPRECATED. It has moved into its own /form folder. Please import sass/form/_all instead.\"\n" }, { "path": "guide/style/bulma/sass/elements/icon.sass", "content": "$icon-dimensions: 1.5rem !default\n$icon-dimensions-small: 1rem !default\n$icon-dimensions-medium: 2rem !default\n$icon-dimensions-large: 3rem !default\n$icon-text-spacing: 0.25em !default\n\n.icon\n align-items: center\n display: inline-flex\n justify-content: center\n height: $icon-dimensions\n width: $icon-dimensions\n // Sizes\n &.is-small\n height: $icon-dimensions-small\n width: $icon-dimensions-small\n &.is-medium\n height: $icon-dimensions-medium\n width: $icon-dimensions-medium\n &.is-large\n height: $icon-dimensions-large\n width: $icon-dimensions-large\n\n.icon-text\n align-items: flex-start\n color: inherit\n display: inline-flex\n flex-wrap: wrap\n line-height: $icon-dimensions\n vertical-align: top\n .icon\n flex-grow: 0\n flex-shrink: 0\n &:not(:last-child)\n +ltr\n margin-right: $icon-text-spacing\n +rtl\n margin-left: $icon-text-spacing\n &:not(:first-child)\n +ltr\n margin-left: $icon-text-spacing\n +rtl\n margin-right: $icon-text-spacing\n\ndiv.icon-text\n display: flex\n" }, { "path": "guide/style/bulma/sass/elements/image.sass", "content": "@import \"../utilities/mixins\"\n\n$dimensions: 16 24 32 48 64 96 128 !default\n\n.image\n display: block\n position: relative\n img\n display: block\n height: auto\n width: 100%\n &.is-rounded\n border-radius: $radius-rounded\n &.is-fullwidth\n width: 100%\n // Ratio\n &.is-square,\n &.is-1by1,\n &.is-5by4,\n &.is-4by3,\n &.is-3by2,\n &.is-5by3,\n &.is-16by9,\n &.is-2by1,\n &.is-3by1,\n &.is-4by5,\n &.is-3by4,\n &.is-2by3,\n &.is-3by5,\n &.is-9by16,\n &.is-1by2,\n &.is-1by3\n img,\n .has-ratio\n @extend %overlay\n height: 100%\n width: 100%\n &.is-square,\n &.is-1by1\n padding-top: 100%\n &.is-5by4\n padding-top: 80%\n &.is-4by3\n padding-top: 75%\n &.is-3by2\n padding-top: 66.6666%\n &.is-5by3\n padding-top: 60%\n &.is-16by9\n padding-top: 56.25%\n &.is-2by1\n padding-top: 50%\n &.is-3by1\n padding-top: 33.3333%\n &.is-4by5\n padding-top: 125%\n &.is-3by4\n padding-top: 133.3333%\n &.is-2by3\n padding-top: 150%\n &.is-3by5\n padding-top: 166.6666%\n &.is-9by16\n padding-top: 177.7777%\n &.is-1by2\n padding-top: 200%\n &.is-1by3\n padding-top: 300%\n // Sizes\n @each $dimension in $dimensions\n &.is-#{$dimension}x#{$dimension}\n height: $dimension * 1px\n width: $dimension * 1px\n" }, { "path": "guide/style/bulma/sass/elements/notification.sass", "content": "@import \"../utilities/mixins\"\n\n$notification-background-color: $background !default\n$notification-code-background-color: $scheme-main !default\n$notification-radius: $radius !default\n$notification-padding: 1.25rem 2.5rem 1.25rem 1.5rem !default\n$notification-padding-ltr: 1.25rem 2.5rem 1.25rem 1.5rem !default\n$notification-padding-rtl: 1.25rem 1.5rem 1.25rem 2.5rem !default\n\n$notification-colors: $colors !default\n\n.notification\n @extend %block\n background-color: $notification-background-color\n border-radius: $notification-radius\n position: relative\n +ltr\n padding: $notification-padding-ltr\n +rtl\n padding: $notification-padding-rtl\n a:not(.button):not(.dropdown-item)\n color: currentColor\n text-decoration: underline\n strong\n color: currentColor\n code,\n pre\n background: $notification-code-background-color\n pre code\n background: transparent\n & > .delete\n +ltr-position(0.5rem)\n position: absolute\n top: 0.5rem\n .title,\n .subtitle,\n .content\n color: currentColor\n // Colors\n @each $name, $pair in $notification-colors\n $color: nth($pair, 1)\n $color-invert: nth($pair, 2)\n &.is-#{$name}\n background-color: $color\n color: $color-invert\n // If light and dark colors are provided\n @if length($pair) >= 4\n $color-light: nth($pair, 3)\n $color-dark: nth($pair, 4)\n &.is-light\n background-color: $color-light\n color: $color-dark\n" }, { "path": "guide/style/bulma/sass/elements/other.sass", "content": "@import \"../utilities/mixins\"\n\n.block\n @extend %block\n\n.delete\n @extend %delete\n\n.heading\n display: block\n font-size: 11px\n letter-spacing: 1px\n margin-bottom: 5px\n text-transform: uppercase\n\n.loader\n @extend %loader\n\n.number\n align-items: center\n background-color: $background\n border-radius: $radius-rounded\n display: inline-flex\n font-size: $size-medium\n height: 2em\n justify-content: center\n margin-right: 1.5rem\n min-width: 2.5em\n padding: 0.25rem 0.5rem\n text-align: center\n vertical-align: top\n" }, { "path": "guide/style/bulma/sass/elements/progress.sass", "content": "@import \"../utilities/mixins\"\n\n$progress-bar-background-color: $border-light !default\n$progress-value-background-color: $text !default\n$progress-border-radius: $radius-rounded !default\n\n$progress-indeterminate-duration: 1.5s !default\n\n$progress-colors: $colors !default\n\n.progress\n @extend %block\n -moz-appearance: none\n -webkit-appearance: none\n border: none\n border-radius: $progress-border-radius\n display: block\n height: $size-normal\n overflow: hidden\n padding: 0\n width: 100%\n &::-webkit-progress-bar\n background-color: $progress-bar-background-color\n &::-webkit-progress-value\n background-color: $progress-value-background-color\n &::-moz-progress-bar\n background-color: $progress-value-background-color\n &::-ms-fill\n background-color: $progress-value-background-color\n border: none\n // Colors\n @each $name, $pair in $progress-colors\n $color: nth($pair, 1)\n &.is-#{$name}\n &::-webkit-progress-value\n background-color: $color\n &::-moz-progress-bar\n background-color: $color\n &::-ms-fill\n background-color: $color\n &:indeterminate\n background-image: linear-gradient(to right, $color 30%, $progress-bar-background-color 30%)\n\n &:indeterminate\n animation-duration: $progress-indeterminate-duration\n animation-iteration-count: infinite\n animation-name: moveIndeterminate\n animation-timing-function: linear\n background-color: $progress-bar-background-color\n background-image: linear-gradient(to right, $text 30%, $progress-bar-background-color 30%)\n background-position: top left\n background-repeat: no-repeat\n background-size: 150% 150%\n &::-webkit-progress-bar\n background-color: transparent\n &::-moz-progress-bar\n background-color: transparent\n &::-ms-fill\n animation-name: none\n\n // Sizes\n &.is-small\n height: $size-small\n &.is-medium\n height: $size-medium\n &.is-large\n height: $size-large\n\n@keyframes moveIndeterminate\n from\n background-position: 200% 0\n to\n background-position: -200% 0\n" }, { "path": "guide/style/bulma/sass/elements/table.sass", "content": "@import \"../utilities/mixins\"\n\n$table-color: $text-strong !default\n$table-background-color: $scheme-main !default\n\n$table-cell-border: 1px solid $border !default\n$table-cell-border-width: 0 0 1px !default\n$table-cell-padding: 0.5em 0.75em !default\n$table-cell-heading-color: $text-strong !default\n$table-cell-text-align: left !default\n\n$table-head-cell-border-width: 0 0 2px !default\n$table-head-cell-color: $text-strong !default\n$table-foot-cell-border-width: 2px 0 0 !default\n$table-foot-cell-color: $text-strong !default\n\n$table-head-background-color: transparent !default\n$table-body-background-color: transparent !default\n$table-foot-background-color: transparent !default\n\n$table-row-hover-background-color: $scheme-main-bis !default\n\n$table-row-active-background-color: $primary !default\n$table-row-active-color: $primary-invert !default\n\n$table-striped-row-even-background-color: $scheme-main-bis !default\n$table-striped-row-even-hover-background-color: $scheme-main-ter !default\n\n$table-colors: $colors !default\n\n.table\n @extend %block\n background-color: $table-background-color\n color: $table-color\n td,\n th\n border: $table-cell-border\n border-width: $table-cell-border-width\n padding: $table-cell-padding\n vertical-align: top\n // Colors\n @each $name, $pair in $table-colors\n $color: nth($pair, 1)\n $color-invert: nth($pair, 2)\n &.is-#{$name}\n background-color: $color\n border-color: $color\n color: $color-invert\n // Modifiers\n &.is-narrow\n white-space: nowrap\n width: 1%\n &.is-selected\n background-color: $table-row-active-background-color\n color: $table-row-active-color\n a,\n strong\n color: currentColor\n &.is-vcentered\n vertical-align: middle\n th\n color: $table-cell-heading-color\n &:not([align])\n text-align: $table-cell-text-align\n tr\n &.is-selected\n background-color: $table-row-active-background-color\n color: $table-row-active-color\n a,\n strong\n color: currentColor\n td,\n th\n border-color: $table-row-active-color\n color: currentColor\n thead\n background-color: $table-head-background-color\n td,\n th\n border-width: $table-head-cell-border-width\n color: $table-head-cell-color\n tfoot\n background-color: $table-foot-background-color\n td,\n th\n border-width: $table-foot-cell-border-width\n color: $table-foot-cell-color\n tbody\n background-color: $table-body-background-color\n tr\n &:last-child\n td,\n th\n border-bottom-width: 0\n // Modifiers\n &.is-bordered\n td,\n th\n border-width: 1px\n tr\n &:last-child\n td,\n th\n border-bottom-width: 1px\n &.is-fullwidth\n width: 100%\n &.is-hoverable\n tbody\n tr:not(.is-selected)\n &:hover\n background-color: $table-row-hover-background-color\n &.is-striped\n tbody\n tr:not(.is-selected)\n &:hover\n background-color: $table-row-hover-background-color\n &:nth-child(even)\n background-color: $table-striped-row-even-hover-background-color\n &.is-narrow\n td,\n th\n padding: 0.25em 0.5em\n &.is-striped\n tbody\n tr:not(.is-selected)\n &:nth-child(even)\n background-color: $table-striped-row-even-background-color\n\n.table-container\n @extend %block\n +overflow-touch\n overflow: auto\n overflow-y: hidden\n max-width: 100%\n" }, { "path": "guide/style/bulma/sass/elements/tag.sass", "content": "@import \"../utilities/mixins\"\n\n$tag-background-color: $background !default\n$tag-color: $text !default\n$tag-radius: $radius !default\n$tag-delete-margin: 1px !default\n\n$tag-colors: $colors !default\n\n.tags\n align-items: center\n display: flex\n flex-wrap: wrap\n justify-content: flex-start\n .tag\n margin-bottom: 0.5rem\n &:not(:last-child)\n +ltr-property(\"margin\", 0.5rem)\n &:last-child\n margin-bottom: -0.5rem\n &:not(:last-child)\n margin-bottom: 1rem\n // Sizes\n &.are-medium\n .tag:not(.is-normal):not(.is-large)\n font-size: $size-normal\n &.are-large\n .tag:not(.is-normal):not(.is-medium)\n font-size: $size-medium\n &.is-centered\n justify-content: center\n .tag\n margin-right: 0.25rem\n margin-left: 0.25rem\n &.is-right\n justify-content: flex-end\n .tag\n &:not(:first-child)\n margin-left: 0.5rem\n &:not(:last-child)\n margin-right: 0\n &.has-addons\n .tag\n +ltr-property(\"margin\", 0)\n &:not(:first-child)\n +ltr-property(\"margin\", 0, false)\n +ltr\n border-top-left-radius: 0\n border-bottom-left-radius: 0\n +rtl\n border-top-right-radius: 0\n border-bottom-right-radius: 0\n &:not(:last-child)\n +ltr\n border-top-right-radius: 0\n border-bottom-right-radius: 0\n +rtl\n border-top-left-radius: 0\n border-bottom-left-radius: 0\n\n.tag:not(body)\n align-items: center\n background-color: $tag-background-color\n border-radius: $tag-radius\n color: $tag-color\n display: inline-flex\n font-size: $size-small\n height: 2em\n justify-content: center\n line-height: 1.5\n padding-left: 0.75em\n padding-right: 0.75em\n white-space: nowrap\n .delete\n +ltr-property(\"margin\", 0.25rem, false)\n +ltr-property(\"margin\", -0.375rem)\n // Colors\n @each $name, $pair in $tag-colors\n $color: nth($pair, 1)\n $color-invert: nth($pair, 2)\n &.is-#{$name}\n background-color: $color\n color: $color-invert\n // If a light and dark colors are provided\n @if length($pair) > 3\n $color-light: nth($pair, 3)\n $color-dark: nth($pair, 4)\n &.is-light\n background-color: $color-light\n color: $color-dark\n // Sizes\n &.is-normal\n font-size: $size-small\n &.is-medium\n font-size: $size-normal\n &.is-large\n font-size: $size-medium\n .icon\n &:first-child:not(:last-child)\n +ltr-property(\"margin\", -0.375em, false)\n +ltr-property(\"margin\", 0.1875em)\n &:last-child:not(:first-child)\n +ltr-property(\"margin\", 0.1875em, false)\n +ltr-property(\"margin\", -0.375em)\n &:first-child:last-child\n +ltr-property(\"margin\", -0.375em, false)\n +ltr-property(\"margin\", -0.375em)\n // Modifiers\n &.is-delete\n +ltr-property(\"margin\", $tag-delete-margin, false)\n padding: 0\n position: relative\n width: 2em\n &::before,\n &::after\n background-color: currentColor\n content: \"\"\n display: block\n left: 50%\n position: absolute\n top: 50%\n transform: translateX(-50%) translateY(-50%) rotate(45deg)\n transform-origin: center center\n &::before\n height: 1px\n width: 50%\n &::after\n height: 50%\n width: 1px\n &:hover,\n &:focus\n background-color: darken($tag-background-color, 5%)\n &:active\n background-color: darken($tag-background-color, 10%)\n &.is-rounded\n border-radius: $radius-rounded\n\na.tag\n &:hover\n text-decoration: underline\n" }, { "path": "guide/style/bulma/sass/elements/title.sass", "content": "@import \"../utilities/mixins\"\n\n$title-color: $text-strong !default\n$title-family: false !default\n$title-size: $size-3 !default\n$title-weight: $weight-semibold !default\n$title-line-height: 1.125 !default\n$title-strong-color: inherit !default\n$title-strong-weight: inherit !default\n$title-sub-size: 0.75em !default\n$title-sup-size: 0.75em !default\n\n$subtitle-color: $text !default\n$subtitle-family: false !default\n$subtitle-size: $size-5 !default\n$subtitle-weight: $weight-normal !default\n$subtitle-line-height: 1.25 !default\n$subtitle-strong-color: $text-strong !default\n$subtitle-strong-weight: $weight-semibold !default\n$subtitle-negative-margin: -1.25rem !default\n\n.title,\n.subtitle\n @extend %block\n word-break: break-word\n em,\n span\n font-weight: inherit\n sub\n font-size: $title-sub-size\n sup\n font-size: $title-sup-size\n .tag\n vertical-align: middle\n\n.title\n color: $title-color\n @if $title-family\n font-family: $title-family\n font-size: $title-size\n font-weight: $title-weight\n line-height: $title-line-height\n strong\n color: $title-strong-color\n font-weight: $title-strong-weight\n &:not(.is-spaced) + .subtitle\n margin-top: $subtitle-negative-margin\n // Sizes\n @each $size in $sizes\n $i: index($sizes, $size)\n &.is-#{$i}\n font-size: $size\n\n.subtitle\n color: $subtitle-color\n @if $subtitle-family\n font-family: $subtitle-family\n font-size: $subtitle-size\n font-weight: $subtitle-weight\n line-height: $subtitle-line-height\n strong\n color: $subtitle-strong-color\n font-weight: $subtitle-strong-weight\n &:not(.is-spaced) + .title\n margin-top: $subtitle-negative-margin\n // Sizes\n @each $size in $sizes\n $i: index($sizes, $size)\n &.is-#{$i}\n font-size: $size\n" }, { "path": "guide/style/bulma/sass/form/_all.sass", "content": "/* Bulma Form */\n@charset \"utf-8\"\n\n@import \"shared\"\n@import \"input-textarea\"\n@import \"checkbox-radio\"\n@import \"select\"\n@import \"file\"\n@import \"tools\"\n" }, { "path": "guide/style/bulma/sass/form/checkbox-radio.sass", "content": "%checkbox-radio\n cursor: pointer\n display: inline-block\n line-height: 1.25\n position: relative\n input\n cursor: pointer\n &:hover\n color: $input-hover-color\n &[disabled],\n fieldset[disabled] &,\n input[disabled]\n color: $input-disabled-color\n cursor: not-allowed\n\n.checkbox\n @extend %checkbox-radio\n\n.radio\n @extend %checkbox-radio\n & + .radio\n +ltr-property(\"margin\", 0.5em, false)\n" }, { "path": "guide/style/bulma/sass/form/file.sass", "content": "$file-border-color: $border !default\n$file-radius: $radius !default\n\n$file-cta-background-color: $scheme-main-ter !default\n$file-cta-color: $text !default\n$file-cta-hover-color: $text-strong !default\n$file-cta-active-color: $text-strong !default\n\n$file-name-border-color: $border !default\n$file-name-border-style: solid !default\n$file-name-border-width: 1px 1px 1px 0 !default\n$file-name-max-width: 16em !default\n\n$file-colors: $form-colors !default\n\n.file\n @extend %unselectable\n align-items: stretch\n display: flex\n justify-content: flex-start\n position: relative\n // Colors\n @each $name, $pair in $file-colors\n $color: nth($pair, 1)\n $color-invert: nth($pair, 2)\n &.is-#{$name}\n .file-cta\n background-color: $color\n border-color: transparent\n color: $color-invert\n &:hover,\n &.is-hovered\n .file-cta\n background-color: bulmaDarken($color, 2.5%)\n border-color: transparent\n color: $color-invert\n &:focus,\n &.is-focused\n .file-cta\n border-color: transparent\n box-shadow: 0 0 0.5em bulmaRgba($color, 0.25)\n color: $color-invert\n &:active,\n &.is-active\n .file-cta\n background-color: bulmaDarken($color, 5%)\n border-color: transparent\n color: $color-invert\n // Sizes\n &.is-small\n font-size: $size-small\n &.is-normal\n font-size: $size-normal\n &.is-medium\n font-size: $size-medium\n .file-icon\n .fa\n font-size: 21px\n &.is-large\n font-size: $size-large\n .file-icon\n .fa\n font-size: 28px\n // Modifiers\n &.has-name\n .file-cta\n border-bottom-right-radius: 0\n border-top-right-radius: 0\n .file-name\n border-bottom-left-radius: 0\n border-top-left-radius: 0\n &.is-empty\n .file-cta\n border-radius: $file-radius\n .file-name\n display: none\n &.is-boxed\n .file-label\n flex-direction: column\n .file-cta\n flex-direction: column\n height: auto\n padding: 1em 3em\n .file-name\n border-width: 0 1px 1px\n .file-icon\n height: 1.5em\n width: 1.5em\n .fa\n font-size: 21px\n &.is-small\n .file-icon .fa\n font-size: 14px\n &.is-medium\n .file-icon .fa\n font-size: 28px\n &.is-large\n .file-icon .fa\n font-size: 35px\n &.has-name\n .file-cta\n border-radius: $file-radius $file-radius 0 0\n .file-name\n border-radius: 0 0 $file-radius $file-radius\n border-width: 0 1px 1px\n &.is-centered\n justify-content: center\n &.is-fullwidth\n .file-label\n width: 100%\n .file-name\n flex-grow: 1\n max-width: none\n &.is-right\n justify-content: flex-end\n .file-cta\n border-radius: 0 $file-radius $file-radius 0\n .file-name\n border-radius: $file-radius 0 0 $file-radius\n border-width: 1px 0 1px 1px\n order: -1\n\n.file-label\n align-items: stretch\n display: flex\n cursor: pointer\n justify-content: flex-start\n overflow: hidden\n position: relative\n &:hover\n .file-cta\n background-color: bulmaDarken($file-cta-background-color, 2.5%)\n color: $file-cta-hover-color\n .file-name\n border-color: bulmaDarken($file-name-border-color, 2.5%)\n &:active\n .file-cta\n background-color: bulmaDarken($file-cta-background-color, 5%)\n color: $file-cta-active-color\n .file-name\n border-color: bulmaDarken($file-name-border-color, 5%)\n\n.file-input\n height: 100%\n left: 0\n opacity: 0\n outline: none\n position: absolute\n top: 0\n width: 100%\n\n.file-cta,\n.file-name\n @extend %control\n border-color: $file-border-color\n border-radius: $file-radius\n font-size: 1em\n padding-left: 1em\n padding-right: 1em\n white-space: nowrap\n\n.file-cta\n background-color: $file-cta-background-color\n color: $file-cta-color\n\n.file-name\n border-color: $file-name-border-color\n border-style: $file-name-border-style\n border-width: $file-name-border-width\n display: block\n max-width: $file-name-max-width\n overflow: hidden\n text-align: inherit\n text-overflow: ellipsis\n\n.file-icon\n align-items: center\n display: flex\n height: 1em\n justify-content: center\n +ltr-property(\"margin\", 0.5em)\n width: 1em\n .fa\n font-size: 14px\n" }, { "path": "guide/style/bulma/sass/form/input-textarea.sass", "content": "$textarea-padding: $control-padding-horizontal !default\n$textarea-max-height: 40em !default\n$textarea-min-height: 8em !default\n\n$textarea-colors: $form-colors !default\n\n%input-textarea\n @extend %input\n box-shadow: $input-shadow\n max-width: 100%\n width: 100%\n &[readonly]\n box-shadow: none\n // Colors\n @each $name, $pair in $textarea-colors\n $color: nth($pair, 1)\n &.is-#{$name}\n border-color: $color\n &:focus,\n &.is-focused,\n &:active,\n &.is-active\n box-shadow: $input-focus-box-shadow-size bulmaRgba($color, 0.25)\n // Sizes\n &.is-small\n +control-small\n &.is-medium\n +control-medium\n &.is-large\n +control-large\n // Modifiers\n &.is-fullwidth\n display: block\n width: 100%\n &.is-inline\n display: inline\n width: auto\n\n.input\n @extend %input-textarea\n &.is-rounded\n border-radius: $radius-rounded\n padding-left: calc(#{$control-padding-horizontal} + 0.375em)\n padding-right: calc(#{$control-padding-horizontal} + 0.375em)\n &.is-static\n background-color: transparent\n border-color: transparent\n box-shadow: none\n padding-left: 0\n padding-right: 0\n\n.textarea\n @extend %input-textarea\n display: block\n max-width: 100%\n min-width: 100%\n padding: $textarea-padding\n resize: vertical\n &:not([rows])\n max-height: $textarea-max-height\n min-height: $textarea-min-height\n &[rows]\n height: initial\n // Modifiers\n &.has-fixed-size\n resize: none\n" }, { "path": "guide/style/bulma/sass/form/select.sass", "content": "$select-colors: $form-colors !default\n\n.select\n display: inline-block\n max-width: 100%\n position: relative\n vertical-align: top\n &:not(.is-multiple)\n height: $input-height\n &:not(.is-multiple):not(.is-loading)\n &::after\n @extend %arrow\n border-color: $input-arrow\n +ltr-position(1.125em)\n z-index: 4\n &.is-rounded\n select\n border-radius: $radius-rounded\n +ltr-property(\"padding\", 1em, false)\n select\n @extend %input\n cursor: pointer\n display: block\n font-size: 1em\n max-width: 100%\n outline: none\n &::-ms-expand\n display: none\n &[disabled]:hover,\n fieldset[disabled] &:hover\n border-color: $input-disabled-border-color\n &:not([multiple])\n +ltr-property(\"padding\", 2.5em)\n &[multiple]\n height: auto\n padding: 0\n option\n padding: 0.5em 1em\n // States\n &:not(.is-multiple):not(.is-loading):hover\n &::after\n border-color: $input-hover-color\n // Colors\n @each $name, $pair in $select-colors\n $color: nth($pair, 1)\n &.is-#{$name}\n &:not(:hover)::after\n border-color: $color\n select\n border-color: $color\n &:hover,\n &.is-hovered\n border-color: bulmaDarken($color, 5%)\n &:focus,\n &.is-focused,\n &:active,\n &.is-active\n box-shadow: $input-focus-box-shadow-size bulmaRgba($color, 0.25)\n // Sizes\n &.is-small\n +control-small\n &.is-medium\n +control-medium\n &.is-large\n +control-large\n // Modifiers\n &.is-disabled\n &::after\n border-color: $input-disabled-color !important\n opacity: 0.5\n &.is-fullwidth\n width: 100%\n select\n width: 100%\n &.is-loading\n &::after\n @extend %loader\n margin-top: 0\n position: absolute\n +ltr-position(0.625em)\n top: 0.625em\n transform: none\n &.is-small:after\n font-size: $size-small\n &.is-medium:after\n font-size: $size-medium\n &.is-large:after\n font-size: $size-large\n" }, { "path": "guide/style/bulma/sass/form/shared.sass", "content": "@import \"../utilities/controls\"\n@import \"../utilities/mixins\"\n\n$form-colors: $colors !default\n\n$input-color: $text-strong !default\n$input-background-color: $scheme-main !default\n$input-border-color: $border !default\n$input-height: $control-height !default\n$input-shadow: inset 0 0.0625em 0.125em rgba($scheme-invert, 0.05) !default\n$input-placeholder-color: bulmaRgba($input-color, 0.3) !default\n\n$input-hover-color: $text-strong !default\n$input-hover-border-color: $border-hover !default\n\n$input-focus-color: $text-strong !default\n$input-focus-border-color: $link !default\n$input-focus-box-shadow-size: 0 0 0 0.125em !default\n$input-focus-box-shadow-color: bulmaRgba($link, 0.25) !default\n\n$input-disabled-color: $text-light !default\n$input-disabled-background-color: $background !default\n$input-disabled-border-color: $background !default\n$input-disabled-placeholder-color: bulmaRgba($input-disabled-color, 0.3) !default\n\n$input-arrow: $link !default\n\n$input-icon-color: $border !default\n$input-icon-active-color: $text !default\n\n$input-radius: $radius !default\n\n=input\n @extend %control\n background-color: $input-background-color\n border-color: $input-border-color\n border-radius: $input-radius\n color: $input-color\n +placeholder\n color: $input-placeholder-color\n &:hover,\n &.is-hovered\n border-color: $input-hover-border-color\n &:focus,\n &.is-focused,\n &:active,\n &.is-active\n border-color: $input-focus-border-color\n box-shadow: $input-focus-box-shadow-size $input-focus-box-shadow-color\n &[disabled],\n fieldset[disabled] &\n background-color: $input-disabled-background-color\n border-color: $input-disabled-border-color\n box-shadow: none\n color: $input-disabled-color\n +placeholder\n color: $input-disabled-placeholder-color\n\n%input\n +input\n" }, { "path": "guide/style/bulma/sass/form/tools.sass", "content": "$label-color: $text-strong !default\n$label-weight: $weight-bold !default\n\n$help-size: $size-small !default\n\n$label-colors: $form-colors !default\n\n.label\n color: $label-color\n display: block\n font-size: $size-normal\n font-weight: $label-weight\n &:not(:last-child)\n margin-bottom: 0.5em\n // Sizes\n &.is-small\n font-size: $size-small\n &.is-medium\n font-size: $size-medium\n &.is-large\n font-size: $size-large\n\n.help\n display: block\n font-size: $help-size\n margin-top: 0.25rem\n @each $name, $pair in $label-colors\n $color: nth($pair, 1)\n &.is-#{$name}\n color: $color\n\n// Containers\n\n.field\n &:not(:last-child)\n margin-bottom: 0.75rem\n // Modifiers\n &.has-addons\n display: flex\n justify-content: flex-start\n .control\n &:not(:last-child)\n +ltr-property(\"margin\", -1px)\n &:not(:first-child):not(:last-child)\n .button,\n .input,\n .select select\n border-radius: 0\n &:first-child:not(:only-child)\n .button,\n .input,\n .select select\n +ltr\n border-bottom-right-radius: 0\n border-top-right-radius: 0\n +rtl\n border-bottom-left-radius: 0\n border-top-left-radius: 0\n &:last-child:not(:only-child)\n .button,\n .input,\n .select select\n +ltr\n border-bottom-left-radius: 0\n border-top-left-radius: 0\n +rtl\n border-bottom-right-radius: 0\n border-top-right-radius: 0\n .button,\n .input,\n .select select\n &:not([disabled])\n &:hover,\n &.is-hovered\n z-index: 2\n &:focus,\n &.is-focused,\n &:active,\n &.is-active\n z-index: 3\n &:hover\n z-index: 4\n &.is-expanded\n flex-grow: 1\n flex-shrink: 1\n &.has-addons-centered\n justify-content: center\n &.has-addons-right\n justify-content: flex-end\n &.has-addons-fullwidth\n .control\n flex-grow: 1\n flex-shrink: 0\n &.is-grouped\n display: flex\n justify-content: flex-start\n & > .control\n flex-shrink: 0\n &:not(:last-child)\n margin-bottom: 0\n +ltr-property(\"margin\", 0.75rem)\n &.is-expanded\n flex-grow: 1\n flex-shrink: 1\n &.is-grouped-centered\n justify-content: center\n &.is-grouped-right\n justify-content: flex-end\n &.is-grouped-multiline\n flex-wrap: wrap\n & > .control\n &:last-child,\n &:not(:last-child)\n margin-bottom: 0.75rem\n &:last-child\n margin-bottom: -0.75rem\n &:not(:last-child)\n margin-bottom: 0\n &.is-horizontal\n +tablet\n display: flex\n\n.field-label\n .label\n font-size: inherit\n +mobile\n margin-bottom: 0.5rem\n +tablet\n flex-basis: 0\n flex-grow: 1\n flex-shrink: 0\n +ltr-property(\"margin\", 1.5rem)\n text-align: right\n &.is-small\n font-size: $size-small\n padding-top: 0.375em\n &.is-normal\n padding-top: 0.375em\n &.is-medium\n font-size: $size-medium\n padding-top: 0.375em\n &.is-large\n font-size: $size-large\n padding-top: 0.375em\n\n.field-body\n .field .field\n margin-bottom: 0\n +tablet\n display: flex\n flex-basis: 0\n flex-grow: 5\n flex-shrink: 1\n .field\n margin-bottom: 0\n & > .field\n flex-shrink: 1\n &:not(.is-narrow)\n flex-grow: 1\n &:not(:last-child)\n +ltr-property(\"margin\", 0.75rem)\n\n.control\n box-sizing: border-box\n clear: both\n font-size: $size-normal\n position: relative\n text-align: inherit\n // Modifiers\n &.has-icons-left,\n &.has-icons-right\n .input,\n .select\n &:focus\n & ~ .icon\n color: $input-icon-active-color\n &.is-small ~ .icon\n font-size: $size-small\n &.is-medium ~ .icon\n font-size: $size-medium\n &.is-large ~ .icon\n font-size: $size-large\n .icon\n color: $input-icon-color\n height: $input-height\n pointer-events: none\n position: absolute\n top: 0\n width: $input-height\n z-index: 4\n &.has-icons-left\n .input,\n .select select\n padding-left: $input-height\n .icon.is-left\n left: 0\n &.has-icons-right\n .input,\n .select select\n padding-right: $input-height\n .icon.is-right\n right: 0\n &.is-loading\n &::after\n @extend %loader\n position: absolute !important\n +ltr-position(0.625em)\n top: 0.625em\n z-index: 4\n &.is-small:after\n font-size: $size-small\n &.is-medium:after\n font-size: $size-medium\n &.is-large:after\n font-size: $size-large\n" }, { "path": "guide/style/bulma/sass/grid/_all.sass", "content": "/* Bulma Grid */\n@charset \"utf-8\"\n\n@import \"columns\"\n@import \"tiles\"\n" }, { "path": "guide/style/bulma/sass/grid/columns.sass", "content": "@import \"../utilities/mixins\"\n\n$column-gap: 0.75rem !default\n\n.column\n display: block\n flex-basis: 0\n flex-grow: 1\n flex-shrink: 1\n padding: $column-gap\n .columns.is-mobile > &.is-narrow\n flex: none\n width: unset\n .columns.is-mobile > &.is-full\n flex: none\n width: 100%\n .columns.is-mobile > &.is-three-quarters\n flex: none\n width: 75%\n .columns.is-mobile > &.is-two-thirds\n flex: none\n width: 66.6666%\n .columns.is-mobile > &.is-half\n flex: none\n width: 50%\n .columns.is-mobile > &.is-one-third\n flex: none\n width: 33.3333%\n .columns.is-mobile > &.is-one-quarter\n flex: none\n width: 25%\n .columns.is-mobile > &.is-one-fifth\n flex: none\n width: 20%\n .columns.is-mobile > &.is-two-fifths\n flex: none\n width: 40%\n .columns.is-mobile > &.is-three-fifths\n flex: none\n width: 60%\n .columns.is-mobile > &.is-four-fifths\n flex: none\n width: 80%\n .columns.is-mobile > &.is-offset-three-quarters\n +ltr-property(\"margin\", 75%, false)\n .columns.is-mobile > &.is-offset-two-thirds\n +ltr-property(\"margin\", 66.6666%, false)\n .columns.is-mobile > &.is-offset-half\n +ltr-property(\"margin\", 50%, false)\n .columns.is-mobile > &.is-offset-one-third\n +ltr-property(\"margin\", 33.3333%, false)\n .columns.is-mobile > &.is-offset-one-quarter\n +ltr-property(\"margin\", 25%, false)\n .columns.is-mobile > &.is-offset-one-fifth\n +ltr-property(\"margin\", 20%, false)\n .columns.is-mobile > &.is-offset-two-fifths\n +ltr-property(\"margin\", 40%, false)\n .columns.is-mobile > &.is-offset-three-fifths\n +ltr-property(\"margin\", 60%, false)\n .columns.is-mobile > &.is-offset-four-fifths\n +ltr-property(\"margin\", 80%, false)\n @for $i from 0 through 12\n .columns.is-mobile > &.is-#{$i}\n flex: none\n width: percentage(divide($i, 12))\n .columns.is-mobile > &.is-offset-#{$i}\n +ltr-property(\"margin\", percentage(divide($i, 12)), false)\n +mobile\n &.is-narrow-mobile\n flex: none\n width: unset\n &.is-full-mobile\n flex: none\n width: 100%\n &.is-three-quarters-mobile\n flex: none\n width: 75%\n &.is-two-thirds-mobile\n flex: none\n width: 66.6666%\n &.is-half-mobile\n flex: none\n width: 50%\n &.is-one-third-mobile\n flex: none\n width: 33.3333%\n &.is-one-quarter-mobile\n flex: none\n width: 25%\n &.is-one-fifth-mobile\n flex: none\n width: 20%\n &.is-two-fifths-mobile\n flex: none\n width: 40%\n &.is-three-fifths-mobile\n flex: none\n width: 60%\n &.is-four-fifths-mobile\n flex: none\n width: 80%\n &.is-offset-three-quarters-mobile\n +ltr-property(\"margin\", 75%, false)\n &.is-offset-two-thirds-mobile\n +ltr-property(\"margin\", 66.6666%, false)\n &.is-offset-half-mobile\n +ltr-property(\"margin\", 50%, false)\n &.is-offset-one-third-mobile\n +ltr-property(\"margin\", 33.3333%, false)\n &.is-offset-one-quarter-mobile\n +ltr-property(\"margin\", 25%, false)\n &.is-offset-one-fifth-mobile\n +ltr-property(\"margin\", 20%, false)\n &.is-offset-two-fifths-mobile\n +ltr-property(\"margin\", 40%, false)\n &.is-offset-three-fifths-mobile\n +ltr-property(\"margin\", 60%, false)\n &.is-offset-four-fifths-mobile\n +ltr-property(\"margin\", 80%, false)\n @for $i from 0 through 12\n &.is-#{$i}-mobile\n flex: none\n width: percentage(divide($i, 12))\n &.is-offset-#{$i}-mobile\n +ltr-property(\"margin\", percentage(divide($i, 12)), false)\n +tablet\n &.is-narrow,\n &.is-narrow-tablet\n flex: none\n width: unset\n &.is-full,\n &.is-full-tablet\n flex: none\n width: 100%\n &.is-three-quarters,\n &.is-three-quarters-tablet\n flex: none\n width: 75%\n &.is-two-thirds,\n &.is-two-thirds-tablet\n flex: none\n width: 66.6666%\n &.is-half,\n &.is-half-tablet\n flex: none\n width: 50%\n &.is-one-third,\n &.is-one-third-tablet\n flex: none\n width: 33.3333%\n &.is-one-quarter,\n &.is-one-quarter-tablet\n flex: none\n width: 25%\n &.is-one-fifth,\n &.is-one-fifth-tablet\n flex: none\n width: 20%\n &.is-two-fifths,\n &.is-two-fifths-tablet\n flex: none\n width: 40%\n &.is-three-fifths,\n &.is-three-fifths-tablet\n flex: none\n width: 60%\n &.is-four-fifths,\n &.is-four-fifths-tablet\n flex: none\n width: 80%\n &.is-offset-three-quarters,\n &.is-offset-three-quarters-tablet\n +ltr-property(\"margin\", 75%, false)\n &.is-offset-two-thirds,\n &.is-offset-two-thirds-tablet\n +ltr-property(\"margin\", 66.6666%, false)\n &.is-offset-half,\n &.is-offset-half-tablet\n +ltr-property(\"margin\", 50%, false)\n &.is-offset-one-third,\n &.is-offset-one-third-tablet\n +ltr-property(\"margin\", 33.3333%, false)\n &.is-offset-one-quarter,\n &.is-offset-one-quarter-tablet\n +ltr-property(\"margin\", 25%, false)\n &.is-offset-one-fifth,\n &.is-offset-one-fifth-tablet\n +ltr-property(\"margin\", 20%, false)\n &.is-offset-two-fifths,\n &.is-offset-two-fifths-tablet\n +ltr-property(\"margin\", 40%, false)\n &.is-offset-three-fifths,\n &.is-offset-three-fifths-tablet\n +ltr-property(\"margin\", 60%, false)\n &.is-offset-four-fifths,\n &.is-offset-four-fifths-tablet\n +ltr-property(\"margin\", 80%, false)\n @for $i from 0 through 12\n &.is-#{$i},\n &.is-#{$i}-tablet\n flex: none\n width: percentage(divide($i, 12))\n &.is-offset-#{$i},\n &.is-offset-#{$i}-tablet\n +ltr-property(\"margin\", percentage(divide($i, 12)), false)\n +touch\n &.is-narrow-touch\n flex: none\n width: unset\n &.is-full-touch\n flex: none\n width: 100%\n &.is-three-quarters-touch\n flex: none\n width: 75%\n &.is-two-thirds-touch\n flex: none\n width: 66.6666%\n &.is-half-touch\n flex: none\n width: 50%\n &.is-one-third-touch\n flex: none\n width: 33.3333%\n &.is-one-quarter-touch\n flex: none\n width: 25%\n &.is-one-fifth-touch\n flex: none\n width: 20%\n &.is-two-fifths-touch\n flex: none\n width: 40%\n &.is-three-fifths-touch\n flex: none\n width: 60%\n &.is-four-fifths-touch\n flex: none\n width: 80%\n &.is-offset-three-quarters-touch\n +ltr-property(\"margin\", 75%, false)\n &.is-offset-two-thirds-touch\n +ltr-property(\"margin\", 66.6666%, false)\n &.is-offset-half-touch\n +ltr-property(\"margin\", 50%, false)\n &.is-offset-one-third-touch\n +ltr-property(\"margin\", 33.3333%, false)\n &.is-offset-one-quarter-touch\n +ltr-property(\"margin\", 25%, false)\n &.is-offset-one-fifth-touch\n +ltr-property(\"margin\", 20%, false)\n &.is-offset-two-fifths-touch\n +ltr-property(\"margin\", 40%, false)\n &.is-offset-three-fifths-touch\n +ltr-property(\"margin\", 60%, false)\n &.is-offset-four-fifths-touch\n +ltr-property(\"margin\", 80%, false)\n @for $i from 0 through 12\n &.is-#{$i}-touch\n flex: none\n width: percentage(divide($i, 12))\n &.is-offset-#{$i}-touch\n +ltr-property(\"margin\", percentage(divide($i, 12)), false)\n +desktop\n &.is-narrow-desktop\n flex: none\n width: unset\n &.is-full-desktop\n flex: none\n width: 100%\n &.is-three-quarters-desktop\n flex: none\n width: 75%\n &.is-two-thirds-desktop\n flex: none\n width: 66.6666%\n &.is-half-desktop\n flex: none\n width: 50%\n &.is-one-third-desktop\n flex: none\n width: 33.3333%\n &.is-one-quarter-desktop\n flex: none\n width: 25%\n &.is-one-fifth-desktop\n flex: none\n width: 20%\n &.is-two-fifths-desktop\n flex: none\n width: 40%\n &.is-three-fifths-desktop\n flex: none\n width: 60%\n &.is-four-fifths-desktop\n flex: none\n width: 80%\n &.is-offset-three-quarters-desktop\n +ltr-property(\"margin\", 75%, false)\n &.is-offset-two-thirds-desktop\n +ltr-property(\"margin\", 66.6666%, false)\n &.is-offset-half-desktop\n +ltr-property(\"margin\", 50%, false)\n &.is-offset-one-third-desktop\n +ltr-property(\"margin\", 33.3333%, false)\n &.is-offset-one-quarter-desktop\n +ltr-property(\"margin\", 25%, false)\n &.is-offset-one-fifth-desktop\n +ltr-property(\"margin\", 20%, false)\n &.is-offset-two-fifths-desktop\n +ltr-property(\"margin\", 40%, false)\n &.is-offset-three-fifths-desktop\n +ltr-property(\"margin\", 60%, false)\n &.is-offset-four-fifths-desktop\n +ltr-property(\"margin\", 80%, false)\n @for $i from 0 through 12\n &.is-#{$i}-desktop\n flex: none\n width: percentage(divide($i, 12))\n &.is-offset-#{$i}-desktop\n +ltr-property(\"margin\", percentage(divide($i, 12)), false)\n +widescreen\n &.is-narrow-widescreen\n flex: none\n width: unset\n &.is-full-widescreen\n flex: none\n width: 100%\n &.is-three-quarters-widescreen\n flex: none\n width: 75%\n &.is-two-thirds-widescreen\n flex: none\n width: 66.6666%\n &.is-half-widescreen\n flex: none\n width: 50%\n &.is-one-third-widescreen\n flex: none\n width: 33.3333%\n &.is-one-quarter-widescreen\n flex: none\n width: 25%\n &.is-one-fifth-widescreen\n flex: none\n width: 20%\n &.is-two-fifths-widescreen\n flex: none\n width: 40%\n &.is-three-fifths-widescreen\n flex: none\n width: 60%\n &.is-four-fifths-widescreen\n flex: none\n width: 80%\n &.is-offset-three-quarters-widescreen\n +ltr-property(\"margin\", 75%, false)\n &.is-offset-two-thirds-widescreen\n +ltr-property(\"margin\", 66.6666%, false)\n &.is-offset-half-widescreen\n +ltr-property(\"margin\", 50%, false)\n &.is-offset-one-third-widescreen\n +ltr-property(\"margin\", 33.3333%, false)\n &.is-offset-one-quarter-widescreen\n +ltr-property(\"margin\", 25%, false)\n &.is-offset-one-fifth-widescreen\n +ltr-property(\"margin\", 20%, false)\n &.is-offset-two-fifths-widescreen\n +ltr-property(\"margin\", 40%, false)\n &.is-offset-three-fifths-widescreen\n +ltr-property(\"margin\", 60%, false)\n &.is-offset-four-fifths-widescreen\n +ltr-property(\"margin\", 80%, false)\n @for $i from 0 through 12\n &.is-#{$i}-widescreen\n flex: none\n width: percentage(divide($i, 12))\n &.is-offset-#{$i}-widescreen\n +ltr-property(\"margin\", percentage(divide($i, 12)), false)\n +fullhd\n &.is-narrow-fullhd\n flex: none\n width: unset\n &.is-full-fullhd\n flex: none\n width: 100%\n &.is-three-quarters-fullhd\n flex: none\n width: 75%\n &.is-two-thirds-fullhd\n flex: none\n width: 66.6666%\n &.is-half-fullhd\n flex: none\n width: 50%\n &.is-one-third-fullhd\n flex: none\n width: 33.3333%\n &.is-one-quarter-fullhd\n flex: none\n width: 25%\n &.is-one-fifth-fullhd\n flex: none\n width: 20%\n &.is-two-fifths-fullhd\n flex: none\n width: 40%\n &.is-three-fifths-fullhd\n flex: none\n width: 60%\n &.is-four-fifths-fullhd\n flex: none\n width: 80%\n &.is-offset-three-quarters-fullhd\n +ltr-property(\"margin\", 75%, false)\n &.is-offset-two-thirds-fullhd\n +ltr-property(\"margin\", 66.6666%, false)\n &.is-offset-half-fullhd\n +ltr-property(\"margin\", 50%, false)\n &.is-offset-one-third-fullhd\n +ltr-property(\"margin\", 33.3333%, false)\n &.is-offset-one-quarter-fullhd\n +ltr-property(\"margin\", 25%, false)\n &.is-offset-one-fifth-fullhd\n +ltr-property(\"margin\", 20%, false)\n &.is-offset-two-fifths-fullhd\n +ltr-property(\"margin\", 40%, false)\n &.is-offset-three-fifths-fullhd\n +ltr-property(\"margin\", 60%, false)\n &.is-offset-four-fifths-fullhd\n +ltr-property(\"margin\", 80%, false)\n @for $i from 0 through 12\n &.is-#{$i}-fullhd\n flex: none\n width: percentage(divide($i, 12))\n &.is-offset-#{$i}-fullhd\n +ltr-property(\"margin\", percentage(divide($i, 12)), false)\n\n.columns\n +ltr-property(\"margin\", (-$column-gap), false)\n +ltr-property(\"margin\", (-$column-gap))\n margin-top: (-$column-gap)\n &:last-child\n margin-bottom: (-$column-gap)\n &:not(:last-child)\n margin-bottom: calc(1.5rem - #{$column-gap})\n // Modifiers\n &.is-centered\n justify-content: center\n &.is-gapless\n +ltr-property(\"margin\", 0, false)\n +ltr-property(\"margin\", 0)\n margin-top: 0\n & > .column\n margin: 0\n padding: 0 !important\n &:not(:last-child)\n margin-bottom: 1.5rem\n &:last-child\n margin-bottom: 0\n &.is-mobile\n display: flex\n &.is-multiline\n flex-wrap: wrap\n &.is-vcentered\n align-items: center\n // Responsiveness\n +tablet\n &:not(.is-desktop)\n display: flex\n +desktop\n // Modifiers\n &.is-desktop\n display: flex\n\n@if $variable-columns\n .columns.is-variable\n --columnGap: 0.75rem\n +ltr-property(\"margin\", calc(-1 * var(--columnGap)), false)\n +ltr-property(\"margin\", calc(-1 * var(--columnGap)))\n > .column\n padding-left: var(--columnGap)\n padding-right: var(--columnGap)\n @for $i from 0 through 8\n &.is-#{$i}\n --columnGap: #{$i * 0.25rem}\n +mobile\n &.is-#{$i}-mobile\n --columnGap: #{$i * 0.25rem}\n +tablet\n &.is-#{$i}-tablet\n --columnGap: #{$i * 0.25rem}\n +tablet-only\n &.is-#{$i}-tablet-only\n --columnGap: #{$i * 0.25rem}\n +touch\n &.is-#{$i}-touch\n --columnGap: #{$i * 0.25rem}\n +desktop\n &.is-#{$i}-desktop\n --columnGap: #{$i * 0.25rem}\n +desktop-only\n &.is-#{$i}-desktop-only\n --columnGap: #{$i * 0.25rem}\n +widescreen\n &.is-#{$i}-widescreen\n --columnGap: #{$i * 0.25rem}\n +widescreen-only\n &.is-#{$i}-widescreen-only\n --columnGap: #{$i * 0.25rem}\n +fullhd\n &.is-#{$i}-fullhd\n --columnGap: #{$i * 0.25rem}\n" }, { "path": "guide/style/bulma/sass/grid/tiles.sass", "content": "@import \"../utilities/mixins\"\n\n$tile-spacing: 0.75rem !default\n\n.tile\n align-items: stretch\n display: block\n flex-basis: 0\n flex-grow: 1\n flex-shrink: 1\n min-height: min-content\n // Modifiers\n &.is-ancestor\n margin-left: $tile-spacing * -1\n margin-right: $tile-spacing * -1\n margin-top: $tile-spacing * -1\n &:last-child\n margin-bottom: $tile-spacing * -1\n &:not(:last-child)\n margin-bottom: $tile-spacing\n &.is-child\n margin: 0 !important\n &.is-parent\n padding: $tile-spacing\n &.is-vertical\n flex-direction: column\n & > .tile.is-child:not(:last-child)\n margin-bottom: 1.5rem !important\n // Responsiveness\n +tablet\n &:not(.is-child)\n display: flex\n @for $i from 1 through 12\n &.is-#{$i}\n flex: none\n width: (divide($i, 12)) * 100%\n" }, { "path": "guide/style/bulma/sass/helpers/_all.sass", "content": "/* Bulma Helpers */\n@charset \"utf-8\"\n\n@import \"color\"\n@import \"flexbox\"\n@import \"float\"\n@import \"other\"\n@import \"overflow\"\n@import \"position\"\n@import \"spacing\"\n@import \"typography\"\n@import \"visibility\"\n" }, { "path": "guide/style/bulma/sass/helpers/color.sass", "content": "@import \"../utilities/derived-variables\"\n\n@each $name, $pair in $colors\n $color: nth($pair, 1)\n .has-text-#{$name}\n color: $color !important\n a.has-text-#{$name}\n &:hover,\n &:focus\n color: bulmaDarken($color, 10%) !important\n .has-background-#{$name}\n background-color: $color !important\n @if length($pair) >= 4\n $color-light: nth($pair, 3)\n $color-dark: nth($pair, 4)\n // Light\n .has-text-#{$name}-light\n color: $color-light !important\n a.has-text-#{$name}-light\n &:hover,\n &:focus\n color: bulmaDarken($color-light, 10%) !important\n .has-background-#{$name}-light\n background-color: $color-light !important\n // Dark\n .has-text-#{$name}-dark\n color: $color-dark !important\n a.has-text-#{$name}-dark\n &:hover,\n &:focus\n color: bulmaLighten($color-dark, 10%) !important\n .has-background-#{$name}-dark\n background-color: $color-dark !important\n\n@each $name, $shade in $shades\n .has-text-#{$name}\n color: $shade !important\n .has-background-#{$name}\n background-color: $shade !important\n" }, { "path": "guide/style/bulma/sass/helpers/flexbox.sass", "content": "$flex-direction-values: row, row-reverse, column, column-reverse\n@each $value in $flex-direction-values\n .is-flex-direction-#{$value}\n flex-direction: $value !important\n\n$flex-wrap-values: nowrap, wrap, wrap-reverse\n@each $value in $flex-wrap-values\n .is-flex-wrap-#{$value}\n flex-wrap: $value !important\n\n$justify-content-values: flex-start, flex-end, center, space-between, space-around, space-evenly, start, end, left, right\n@each $value in $justify-content-values\n .is-justify-content-#{$value}\n justify-content: $value !important\n\n$align-content-values: flex-start, flex-end, center, space-between, space-around, space-evenly, stretch, start, end, baseline\n@each $value in $align-content-values\n .is-align-content-#{$value}\n align-content: $value !important\n\n$align-items-values: stretch, flex-start, flex-end, center, baseline, start, end, self-start, self-end\n@each $value in $align-items-values\n .is-align-items-#{$value}\n align-items: $value !important\n\n$align-self-values: auto, flex-start, flex-end, center, baseline, stretch\n@each $value in $align-self-values\n .is-align-self-#{$value}\n align-self: $value !important\n\n$flex-operators: grow, shrink\n@each $operator in $flex-operators\n @for $i from 0 through 5\n .is-flex-#{$operator}-#{$i}\n flex-#{$operator}: $i !important\n" }, { "path": "guide/style/bulma/sass/helpers/float.sass", "content": "@import \"../utilities/mixins\"\n\n.is-clearfix\n +clearfix\n\n.is-pulled-left\n float: left !important\n\n.is-pulled-right\n float: right !important\n" }, { "path": "guide/style/bulma/sass/helpers/other.sass", "content": "@import \"../utilities/mixins\"\n\n.is-radiusless\n border-radius: 0 !important\n\n.is-shadowless\n box-shadow: none !important\n\n.is-clickable\n cursor: pointer !important\n pointer-events: all !important\n\n.is-unselectable\n @extend %unselectable\n" }, { "path": "guide/style/bulma/sass/helpers/overflow.sass", "content": ".is-clipped\n overflow: hidden !important\n" }, { "path": "guide/style/bulma/sass/helpers/position.sass", "content": "@import \"../utilities/mixins\"\n\n.is-overlay\n @extend %overlay\n\n.is-relative\n position: relative !important\n" }, { "path": "guide/style/bulma/sass/helpers/spacing.sass", "content": ".is-marginless\n margin: 0 !important\n\n.is-paddingless\n padding: 0 !important\n\n$spacing-shortcuts: (\"margin\": \"m\", \"padding\": \"p\") !default\n$spacing-directions: (\"top\": \"t\", \"right\": \"r\", \"bottom\": \"b\", \"left\": \"l\") !default\n$spacing-horizontal: \"x\" !default\n$spacing-vertical: \"y\" !default\n$spacing-values: (\"0\": 0, \"1\": 0.25rem, \"2\": 0.5rem, \"3\": 0.75rem, \"4\": 1rem, \"5\": 1.5rem, \"6\": 3rem, \"auto\": auto) !default\n\n@each $property, $shortcut in $spacing-shortcuts\n @each $name, $value in $spacing-values\n // All directions\n .#{$shortcut}-#{$name}\n #{$property}: $value !important\n // Cardinal directions\n @each $direction, $suffix in $spacing-directions\n .#{$shortcut}#{$suffix}-#{$name}\n #{$property}-#{$direction}: $value !important\n // Horizontal axis\n @if $spacing-horizontal != null\n .#{$shortcut}#{$spacing-horizontal}-#{$name}\n #{$property}-left: $value !important\n #{$property}-right: $value !important\n // Vertical axis\n @if $spacing-vertical != null\n .#{$shortcut}#{$spacing-vertical}-#{$name}\n #{$property}-top: $value !important\n #{$property}-bottom: $value !important\n" }, { "path": "guide/style/bulma/sass/helpers/typography.sass", "content": "@import \"../utilities/mixins\"\n\n=typography-size($target:'')\n @each $size in $sizes\n $i: index($sizes, $size)\n .is-size-#{$i}#{if($target == '', '', '-' + $target)}\n font-size: $size !important\n\n+typography-size()\n\n+mobile\n +typography-size('mobile')\n\n+tablet\n +typography-size('tablet')\n\n+touch\n +typography-size('touch')\n\n+desktop\n +typography-size('desktop')\n\n+widescreen\n +typography-size('widescreen')\n\n+fullhd\n +typography-size('fullhd')\n\n$alignments: ('centered': 'center', 'justified': 'justify', 'left': 'left', 'right': 'right')\n\n@each $alignment, $text-align in $alignments\n .has-text-#{$alignment}\n text-align: #{$text-align} !important\n\n@each $alignment, $text-align in $alignments\n +mobile\n .has-text-#{$alignment}-mobile\n text-align: #{$text-align} !important\n +tablet\n .has-text-#{$alignment}-tablet\n text-align: #{$text-align} !important\n +tablet-only\n .has-text-#{$alignment}-tablet-only\n text-align: #{$text-align} !important\n +touch\n .has-text-#{$alignment}-touch\n text-align: #{$text-align} !important\n +desktop\n .has-text-#{$alignment}-desktop\n text-align: #{$text-align} !important\n +desktop-only\n .has-text-#{$alignment}-desktop-only\n text-align: #{$text-align} !important\n +widescreen\n .has-text-#{$alignment}-widescreen\n text-align: #{$text-align} !important\n +widescreen-only\n .has-text-#{$alignment}-widescreen-only\n text-align: #{$text-align} !important\n +fullhd\n .has-text-#{$alignment}-fullhd\n text-align: #{$text-align} !important\n\n.is-capitalized\n text-transform: capitalize !important\n\n.is-lowercase\n text-transform: lowercase !important\n\n.is-uppercase\n text-transform: uppercase !important\n\n.is-italic\n font-style: italic !important\n \n.is-underlined\n text-decoration: underline !important\n\n.has-text-weight-light\n font-weight: $weight-light !important\n.has-text-weight-normal\n font-weight: $weight-normal !important\n.has-text-weight-medium\n font-weight: $weight-medium !important\n.has-text-weight-semibold\n font-weight: $weight-semibold !important\n.has-text-weight-bold\n font-weight: $weight-bold !important\n\n.is-family-primary\n font-family: $family-primary !important\n\n.is-family-secondary\n font-family: $family-secondary !important\n\n.is-family-sans-serif\n font-family: $family-sans-serif !important\n\n.is-family-monospace\n font-family: $family-monospace !important\n\n.is-family-code\n font-family: $family-code !important\n" }, { "path": "guide/style/bulma/sass/helpers/visibility.sass", "content": "@import \"../utilities/mixins\"\n\n$displays: 'block' 'flex' 'inline' 'inline-block' 'inline-flex'\n\n@each $display in $displays\n .is-#{$display}\n display: #{$display} !important\n +mobile\n .is-#{$display}-mobile\n display: #{$display} !important\n +tablet\n .is-#{$display}-tablet\n display: #{$display} !important\n +tablet-only\n .is-#{$display}-tablet-only\n display: #{$display} !important\n +touch\n .is-#{$display}-touch\n display: #{$display} !important\n +desktop\n .is-#{$display}-desktop\n display: #{$display} !important\n +desktop-only\n .is-#{$display}-desktop-only\n display: #{$display} !important\n +widescreen\n .is-#{$display}-widescreen\n display: #{$display} !important\n +widescreen-only\n .is-#{$display}-widescreen-only\n display: #{$display} !important\n +fullhd\n .is-#{$display}-fullhd\n display: #{$display} !important\n\n.is-hidden\n display: none !important\n\n.is-sr-only\n border: none !important\n clip: rect(0, 0, 0, 0) !important\n height: 0.01em !important\n overflow: hidden !important\n padding: 0 !important\n position: absolute !important\n white-space: nowrap !important\n width: 0.01em !important\n\n+mobile\n .is-hidden-mobile\n display: none !important\n\n+tablet\n .is-hidden-tablet\n display: none !important\n\n+tablet-only\n .is-hidden-tablet-only\n display: none !important\n\n+touch\n .is-hidden-touch\n display: none !important\n\n+desktop\n .is-hidden-desktop\n display: none !important\n\n+desktop-only\n .is-hidden-desktop-only\n display: none !important\n\n+widescreen\n .is-hidden-widescreen\n display: none !important\n\n+widescreen-only\n .is-hidden-widescreen-only\n display: none !important\n\n+fullhd\n .is-hidden-fullhd\n display: none !important\n\n.is-invisible\n visibility: hidden !important\n\n+mobile\n .is-invisible-mobile\n visibility: hidden !important\n\n+tablet\n .is-invisible-tablet\n visibility: hidden !important\n\n+tablet-only\n .is-invisible-tablet-only\n visibility: hidden !important\n\n+touch\n .is-invisible-touch\n visibility: hidden !important\n\n+desktop\n .is-invisible-desktop\n visibility: hidden !important\n\n+desktop-only\n .is-invisible-desktop-only\n visibility: hidden !important\n\n+widescreen\n .is-invisible-widescreen\n visibility: hidden !important\n\n+widescreen-only\n .is-invisible-widescreen-only\n visibility: hidden !important\n\n+fullhd\n .is-invisible-fullhd\n visibility: hidden !important\n" }, { "path": "guide/style/bulma/sass/layout/_all.sass", "content": "/* Bulma Layout */\n@charset \"utf-8\"\n\n@import \"hero\"\n@import \"section\"\n@import \"footer\"\n" }, { "path": "guide/style/bulma/sass/layout/footer.sass", "content": "@import \"../utilities/derived-variables\"\n\n$footer-background-color: $scheme-main-bis !default\n$footer-color: false !default\n$footer-padding: 3rem 1.5rem 6rem !default\n\n.footer\n background-color: $footer-background-color\n padding: $footer-padding\n @if $footer-color\n color: $footer-color\n" }, { "path": "guide/style/bulma/sass/layout/hero.sass", "content": "@import \"../utilities/mixins\"\n\n$hero-body-padding: 3rem 1.5rem !default\n$hero-body-padding-tablet: 3rem 3rem !default\n$hero-body-padding-small: 1.5rem !default\n$hero-body-padding-medium: 9rem 4.5rem !default\n$hero-body-padding-large: 18rem 6rem !default\n\n$hero-colors: $colors !default\n\n// Main container\n.hero\n align-items: stretch\n display: flex\n flex-direction: column\n justify-content: space-between\n .navbar\n background: none\n .tabs\n ul\n border-bottom: none\n // Colors\n @each $name, $pair in $hero-colors\n $color: nth($pair, 1)\n $color-invert: nth($pair, 2)\n &.is-#{$name}\n background-color: $color\n color: $color-invert\n a:not(.button):not(.dropdown-item):not(.tag):not(.pagination-link.is-current),\n strong\n color: inherit\n .title\n color: $color-invert\n .subtitle\n color: bulmaRgba($color-invert, 0.9)\n a:not(.button),\n strong\n color: $color-invert\n .navbar-menu\n +touch\n background-color: $color\n .navbar-item,\n .navbar-link\n color: bulmaRgba($color-invert, 0.7)\n a.navbar-item,\n .navbar-link\n &:hover,\n &.is-active\n background-color: bulmaDarken($color, 5%)\n color: $color-invert\n .tabs\n a\n color: $color-invert\n opacity: 0.9\n &:hover\n opacity: 1\n li\n &.is-active a\n color: $color !important\n opacity: 1\n &.is-boxed,\n &.is-toggle\n a\n color: $color-invert\n &:hover\n background-color: bulmaRgba($scheme-invert, 0.1)\n li.is-active a\n &,\n &:hover\n background-color: $color-invert\n border-color: $color-invert\n color: $color\n // Modifiers\n @if type-of($color) == 'color'\n &.is-bold\n $gradient-top-left: darken(saturate(adjust-hue($color, -10deg), 10%), 10%)\n $gradient-bottom-right: lighten(saturate(adjust-hue($color, 10deg), 5%), 5%)\n background-image: linear-gradient(141deg, $gradient-top-left 0%, $color 71%, $gradient-bottom-right 100%)\n +mobile\n .navbar-menu\n background-image: linear-gradient(141deg, $gradient-top-left 0%, $color 71%, $gradient-bottom-right 100%)\n // Sizes\n &.is-small\n .hero-body\n padding: $hero-body-padding-small\n &.is-medium\n +tablet\n .hero-body\n padding: $hero-body-padding-medium\n &.is-large\n +tablet\n .hero-body\n padding: $hero-body-padding-large\n &.is-halfheight,\n &.is-fullheight,\n &.is-fullheight-with-navbar\n .hero-body\n align-items: center\n display: flex\n & > .container\n flex-grow: 1\n flex-shrink: 1\n &.is-halfheight\n min-height: 50vh\n &.is-fullheight\n min-height: 100vh\n\n// Components\n\n.hero-video\n @extend %overlay\n overflow: hidden\n video\n left: 50%\n min-height: 100%\n min-width: 100%\n position: absolute\n top: 50%\n transform: translate3d(-50%, -50%, 0)\n // Modifiers\n &.is-transparent\n opacity: 0.3\n // Responsiveness\n +mobile\n display: none\n\n.hero-buttons\n margin-top: 1.5rem\n // Responsiveness\n +mobile\n .button\n display: flex\n &:not(:last-child)\n margin-bottom: 0.75rem\n +tablet\n display: flex\n justify-content: center\n .button:not(:last-child)\n +ltr-property(\"margin\", 1.5rem)\n\n// Containers\n\n.hero-head,\n.hero-foot\n flex-grow: 0\n flex-shrink: 0\n\n.hero-body\n flex-grow: 1\n flex-shrink: 0\n padding: $hero-body-padding\n +tablet\n padding: $hero-body-padding-tablet\n" }, { "path": "guide/style/bulma/sass/layout/section.sass", "content": "@import \"../utilities/mixins\"\n\n$section-padding: 3rem 1.5rem !default\n$section-padding-desktop: 3rem 3rem !default\n$section-padding-medium: 9rem 4.5rem !default\n$section-padding-large: 18rem 6rem !default\n\n.section\n padding: $section-padding\n // Responsiveness\n +desktop\n padding: $section-padding-desktop\n // Sizes\n &.is-medium\n padding: $section-padding-medium\n &.is-large\n padding: $section-padding-large\n" }, { "path": "guide/style/bulma/sass/utilities/_all.sass", "content": "/* Bulma Utilities */\n@charset \"utf-8\"\n\n@import \"initial-variables\"\n@import \"functions\"\n@import \"derived-variables\"\n@import \"mixins\"\n@import \"controls\"\n@import \"extends\"\n" }, { "path": "guide/style/bulma/sass/utilities/animations.sass", "content": "@warn \"The animations.sass file has MOVED. It is now in the /base folder. Please import sass/base/animations instead.\"\n" }, { "path": "guide/style/bulma/sass/utilities/controls.sass", "content": "@import \"derived-variables\"\n\n$control-radius: $radius !default\n$control-radius-small: $radius-small !default\n\n$control-border-width: 1px !default\n\n$control-height: 2.5em !default\n$control-line-height: 1.5 !default\n\n$control-padding-vertical: calc(0.5em - #{$control-border-width}) !default\n$control-padding-horizontal: calc(0.75em - #{$control-border-width}) !default\n\n=control\n -moz-appearance: none\n -webkit-appearance: none\n align-items: center\n border: $control-border-width solid transparent\n border-radius: $control-radius\n box-shadow: none\n display: inline-flex\n font-size: $size-normal\n height: $control-height\n justify-content: flex-start\n line-height: $control-line-height\n padding-bottom: $control-padding-vertical\n padding-left: $control-padding-horizontal\n padding-right: $control-padding-horizontal\n padding-top: $control-padding-vertical\n position: relative\n vertical-align: top\n // States\n &:focus,\n &.is-focused,\n &:active,\n &.is-active\n outline: none\n &[disabled],\n fieldset[disabled] &\n cursor: not-allowed\n\n// The controls sizes use mixins so they can be used at different breakpoints\n=control-small\n border-radius: $control-radius-small\n font-size: $size-small\n=control-medium\n font-size: $size-medium\n=control-large\n font-size: $size-large\n" }, { "path": "guide/style/bulma/sass/utilities/derived-variables.sass", "content": "@import \"initial-variables\"\n@import \"functions\"\n\n$primary: $turquoise !default\n\n$info: $cyan !default\n$success: $green !default\n$warning: $yellow !default\n$danger: $red !default\n\n$light: $white-ter !default\n$dark: $grey-darker !default\n\n// Invert colors\n\n$orange-invert: findColorInvert($orange) !default\n$yellow-invert: findColorInvert($yellow) !default\n$green-invert: findColorInvert($green) !default\n$turquoise-invert: findColorInvert($turquoise) !default\n$cyan-invert: findColorInvert($cyan) !default\n$blue-invert: findColorInvert($blue) !default\n$purple-invert: findColorInvert($purple) !default\n$red-invert: findColorInvert($red) !default\n\n$primary-invert: findColorInvert($primary) !default\n$primary-light: findLightColor($primary) !default\n$primary-dark: findDarkColor($primary) !default\n$info-invert: findColorInvert($info) !default\n$info-light: findLightColor($info) !default\n$info-dark: findDarkColor($info) !default\n$success-invert: findColorInvert($success) !default\n$success-light: findLightColor($success) !default\n$success-dark: findDarkColor($success) !default\n$warning-invert: findColorInvert($warning) !default\n$warning-light: findLightColor($warning) !default\n$warning-dark: findDarkColor($warning) !default\n$danger-invert: findColorInvert($danger) !default\n$danger-light: findLightColor($danger) !default\n$danger-dark: findDarkColor($danger) !default\n$light-invert: findColorInvert($light) !default\n$dark-invert: findColorInvert($dark) !default\n\n// General colors\n\n$scheme-main: $white !default\n$scheme-main-bis: $white-bis !default\n$scheme-main-ter: $white-ter !default\n$scheme-invert: $black !default\n$scheme-invert-bis: $black-bis !default\n$scheme-invert-ter: $black-ter !default\n\n$background: $white-ter !default\n\n$border: $grey-lighter !default\n$border-hover: $grey-light !default\n$border-light: $grey-lightest !default\n$border-light-hover: $grey-light !default\n\n// Text colors\n\n$text: $grey-dark !default\n$text-invert: findColorInvert($text) !default\n$text-light: $grey !default\n$text-strong: $grey-darker !default\n\n// Code colors\n\n$code: darken($red, 15%) !default\n$code-background: $background !default\n\n$pre: $text !default\n$pre-background: $background !default\n\n// Link colors\n\n$link: $blue !default\n$link-invert: findColorInvert($link) !default\n$link-light: findLightColor($link) !default\n$link-dark: findDarkColor($link) !default\n$link-visited: $purple !default\n\n$link-hover: $grey-darker !default\n$link-hover-border: $grey-light !default\n\n$link-focus: $grey-darker !default\n$link-focus-border: $blue !default\n\n$link-active: $grey-darker !default\n$link-active-border: $grey-dark !default\n\n// Typography\n\n$family-primary: $family-sans-serif !default\n$family-secondary: $family-sans-serif !default\n$family-code: $family-monospace !default\n\n$size-small: $size-7 !default\n$size-normal: $size-6 !default\n$size-medium: $size-5 !default\n$size-large: $size-4 !default\n\n// Effects\n\n$shadow: 0 0.5em 1em -0.125em rgba($scheme-invert, 0.1), 0 0px 0 1px rgba($scheme-invert, 0.02) !default\n\n// Lists and maps\n$custom-colors: null !default\n$custom-shades: null !default\n\n$colors: mergeColorMaps((\"white\": ($white, $black), \"black\": ($black, $white), \"light\": ($light, $light-invert), \"dark\": ($dark, $dark-invert), \"primary\": ($primary, $primary-invert, $primary-light, $primary-dark), \"link\": ($link, $link-invert, $link-light, $link-dark), \"info\": ($info, $info-invert, $info-light, $info-dark), \"success\": ($success, $success-invert, $success-light, $success-dark), \"warning\": ($warning, $warning-invert, $warning-light, $warning-dark), \"danger\": ($danger, $danger-invert, $danger-light, $danger-dark)), $custom-colors) !default\n\n$shades: mergeColorMaps((\"black-bis\": $black-bis, \"black-ter\": $black-ter, \"grey-darker\": $grey-darker, \"grey-dark\": $grey-dark, \"grey\": $grey, \"grey-light\": $grey-light, \"grey-lighter\": $grey-lighter, \"white-ter\": $white-ter, \"white-bis\": $white-bis), $custom-shades) !default\n\n$sizes: $size-1 $size-2 $size-3 $size-4 $size-5 $size-6 $size-7 !default\n" }, { "path": "guide/style/bulma/sass/utilities/extends.sass", "content": "@import \"mixins\"\n\n%control\n +control\n\n%unselectable\n +unselectable\n\n%arrow\n +arrow\n\n%block\n +block\n\n%delete\n +delete\n\n%loader\n +loader\n\n%overlay\n +overlay\n\n%reset\n +reset\n" }, { "path": "guide/style/bulma/sass/utilities/functions.sass", "content": "@function mergeColorMaps($bulma-colors, $custom-colors)\n // We return at least Bulma's hard-coded colors\n $merged-colors: $bulma-colors\n\n // We want a map as input\n @if type-of($custom-colors) == 'map'\n @each $name, $components in $custom-colors\n // The color name should be a string\n // and the components either a single color\n // or a colors list with at least one element\n @if type-of($name) == 'string' and (type-of($components) == 'list' or type-of($components) == 'color') and length($components) >= 1\n $color-base: null\n $color-invert: null\n $color-light: null\n $color-dark: null\n $value: null\n\n // The param can either be a single color\n // or a list of 2 colors\n @if type-of($components) == 'color'\n $color-base: $components\n $color-invert: findColorInvert($color-base)\n $color-light: findLightColor($color-base)\n $color-dark: findDarkColor($color-base)\n @else if type-of($components) == 'list'\n $color-base: nth($components, 1)\n // If Invert, Light and Dark are provided\n @if length($components) > 3\n $color-invert: nth($components, 2)\n $color-light: nth($components, 3)\n $color-dark: nth($components, 4)\n // If only Invert and Light are provided\n @else if length($components) > 2\n $color-invert: nth($components, 2)\n $color-light: nth($components, 3)\n $color-dark: findDarkColor($color-base)\n // If only Invert is provided\n @else\n $color-invert: nth($components, 2)\n $color-light: findLightColor($color-base)\n $color-dark: findDarkColor($color-base)\n\n $value: ($color-base, $color-invert, $color-light, $color-dark)\n\n // We only want to merge the map if the color base is an actual color\n @if type-of($color-base) == 'color'\n // We merge this colors elements as map with Bulma's colors map\n // (we can override them this way, no multiple definition for the same name)\n // $merged-colors: map_merge($merged-colors, ($name: ($color-base, $color-invert, $color-light, $color-dark)))\n $merged-colors: map_merge($merged-colors, ($name: $value))\n\n @return $merged-colors\n\n@function powerNumber($number, $exp)\n $value: 1\n @if $exp > 0\n @for $i from 1 through $exp\n $value: $value * $number\n @else if $exp < 0\n @for $i from 1 through -$exp\n $value: divide($value, $number)\n @return $value\n\n@function colorLuminance($color)\n @if type-of($color) != 'color'\n @return 0.55\n $color-rgb: ('red': red($color),'green': green($color),'blue': blue($color))\n @each $name, $value in $color-rgb\n $adjusted: 0\n $value: divide($value, 255)\n @if $value < 0.03928\n $value: divide($value, 12.92)\n @else\n $value: divide(($value + .055), 1.055)\n $value: powerNumber($value, 2)\n $color-rgb: map-merge($color-rgb, ($name: $value))\n @return (map-get($color-rgb, 'red') * .2126) + (map-get($color-rgb, 'green') * .7152) + (map-get($color-rgb, 'blue') * .0722)\n\n@function findColorInvert($color)\n @if (colorLuminance($color) > 0.55)\n @return rgba(#000, 0.7)\n @else\n @return #fff\n\n@function findLightColor($color, $l: 96%)\n @if type-of($color) == 'color'\n $l: 96%\n @if lightness($color) > 96%\n $l: lightness($color)\n @return change-color($color, $lightness: $l)\n @return $background\n\n@function findDarkColor($color, $base-l: 29%)\n @if type-of($color) == 'color'\n $luminance: colorLuminance($color)\n $luminance-delta: (0.53 - $luminance)\n $target-l: round($base-l + ($luminance-delta * 53))\n @return change-color($color, $lightness: max($base-l, $target-l))\n @return $text-strong\n\n@function bulmaRgba($color, $alpha)\n @if type-of($color) != 'color'\n @return $color\n @return rgba($color, $alpha)\n\n@function bulmaDarken($color, $amount)\n @if type-of($color) != 'color'\n @return $color\n @return darken($color, $amount)\n\n@function bulmaLighten($color, $amount)\n @if type-of($color) != 'color'\n @return $color\n @return lighten($color, $amount)\n\n// Custom divide function by @mdo from https://github.com/twbs/bootstrap/pull/34245\n// Replaces old slash division deprecated in Dart Sass\n@function divide($dividend, $divisor, $precision: 10)\n $sign: if($dividend > 0 and $divisor > 0, 1, -1)\n $dividend: abs($dividend)\n $divisor: abs($divisor)\n $quotient: 0\n $remainder: $dividend\n @if $dividend == 0\n @return 0\n @if $divisor == 0\n @error \"Cannot divide by 0\"\n @if $divisor == 1\n @return $dividend\n @while $remainder >= $divisor\n $quotient: $quotient + 1\n $remainder: $remainder - $divisor\n @if $remainder > 0 and $precision > 0\n $remainder: divide($remainder * 10, $divisor, $precision - 1) * .1\n @return ($quotient + $remainder) * $sign\n" }, { "path": "guide/style/bulma/sass/utilities/initial-variables.sass", "content": "// Colors\n\n$black: hsl(0, 0%, 4%) !default\n$black-bis: hsl(0, 0%, 7%) !default\n$black-ter: hsl(0, 0%, 14%) !default\n\n$grey-darker: hsl(0, 0%, 21%) !default\n$grey-dark: hsl(0, 0%, 29%) !default\n$grey: hsl(0, 0%, 48%) !default\n$grey-light: hsl(0, 0%, 71%) !default\n$grey-lighter: hsl(0, 0%, 86%) !default\n$grey-lightest: hsl(0, 0%, 93%) !default\n\n$white-ter: hsl(0, 0%, 96%) !default\n$white-bis: hsl(0, 0%, 98%) !default\n$white: hsl(0, 0%, 100%) !default\n\n$orange: hsl(14, 100%, 53%) !default\n$yellow: hsl(44, 100%, 77%) !default\n$green: hsl(153, 53%, 53%) !default\n$turquoise: hsl(171, 100%, 41%) !default\n$cyan: hsl(207, 61%, 53%) !default\n$blue: hsl(229, 53%, 53%) !default\n$purple: hsl(271, 100%, 71%) !default\n$red: hsl(348, 86%, 61%) !default\n\n// Typography\n\n$family-sans-serif: BlinkMacSystemFont, -apple-system, \"Segoe UI\", \"Roboto\", \"Oxygen\", \"Ubuntu\", \"Cantarell\", \"Fira Sans\", \"Droid Sans\", \"Helvetica Neue\", \"Helvetica\", \"Arial\", sans-serif !default\n$family-monospace: monospace !default\n$render-mode: optimizeLegibility !default\n\n$size-1: 3rem !default\n$size-2: 2.5rem !default\n$size-3: 2rem !default\n$size-4: 1.5rem !default\n$size-5: 1.25rem !default\n$size-6: 1rem !default\n$size-7: 0.75rem !default\n\n$weight-light: 300 !default\n$weight-normal: 400 !default\n$weight-medium: 500 !default\n$weight-semibold: 600 !default\n$weight-bold: 700 !default\n\n// Spacing\n\n$block-spacing: 1.5rem !default\n\n// Responsiveness\n\n// The container horizontal gap, which acts as the offset for breakpoints\n$gap: 32px !default\n// 960, 1152, and 1344 have been chosen because they are divisible by both 12 and 16\n$tablet: 769px !default\n// 960px container + 4rem\n$desktop: 960px + (2 * $gap) !default\n// 1152px container + 4rem\n$widescreen: 1152px + (2 * $gap) !default\n$widescreen-enabled: true !default\n// 1344px container + 4rem\n$fullhd: 1344px + (2 * $gap) !default\n$fullhd-enabled: true !default\n$breakpoints: (\"mobile\": (\"until\": $tablet), \"tablet\": (\"from\": $tablet), \"tablet-only\": (\"from\": $tablet, \"until\": $desktop), \"touch\": (\"from\": $desktop), \"desktop\": (\"from\": $desktop), \"desktop-only\": (\"from\": $desktop, \"until\": $widescreen), \"until-widescreen\": (\"until\": $widescreen), \"widescreen\": (\"from\": $widescreen), \"widescreen-only\": (\"from\": $widescreen, \"until\": $fullhd), \"until-fullhd\": (\"until\": $fullhd), \"fullhd\": (\"from\": $fullhd)) !default\n\n// Miscellaneous\n\n$easing: ease-out !default\n$radius-small: 2px !default\n$radius: 4px !default\n$radius-large: 6px !default\n$radius-rounded: 9999px !default\n$speed: 86ms !default\n\n// Flags\n\n$variable-columns: true !default\n$rtl: false !default\n" }, { "path": "guide/style/bulma/sass/utilities/mixins.sass", "content": "@import \"derived-variables\"\n\n=clearfix\n &::after\n clear: both\n content: \" \"\n display: table\n\n=center($width, $height: 0)\n position: absolute\n @if $height != 0\n left: calc(50% - (#{$width} * 0.5))\n top: calc(50% - (#{$height} * 0.5))\n @else\n left: calc(50% - (#{$width} * 0.5))\n top: calc(50% - (#{$width} * 0.5))\n\n=fa($size, $dimensions)\n display: inline-block\n font-size: $size\n height: $dimensions\n line-height: $dimensions\n text-align: center\n vertical-align: top\n width: $dimensions\n\n=hamburger($dimensions)\n -moz-appearance: none\n -webkit-appearance: none\n appearance: none\n background: none\n border: none\n cursor: pointer\n display: block\n height: $dimensions\n position: relative\n width: $dimensions\n span\n background-color: currentColor\n display: block\n height: 1px\n left: calc(50% - 8px)\n position: absolute\n transform-origin: center\n transition-duration: $speed\n transition-property: background-color, opacity, transform\n transition-timing-function: $easing\n width: 16px\n &:nth-child(1)\n top: calc(50% - 6px)\n &:nth-child(2)\n top: calc(50% - 1px)\n &:nth-child(3)\n top: calc(50% + 4px)\n &:hover\n background-color: bulmaRgba(black, 0.05)\n // Modifers\n &.is-active\n span\n &:nth-child(1)\n transform: translateY(5px) rotate(45deg)\n &:nth-child(2)\n opacity: 0\n &:nth-child(3)\n transform: translateY(-5px) rotate(-45deg)\n\n=overflow-touch\n -webkit-overflow-scrolling: touch\n\n=placeholder\n $placeholders: ':-moz' ':-webkit-input' '-moz' '-ms-input'\n @each $placeholder in $placeholders\n &:#{$placeholder}-placeholder\n @content\n\n=reset\n -moz-appearance: none\n -webkit-appearance: none\n appearance: none\n background: none\n border: none\n color: currentColor\n font-family: inherit\n font-size: 1em\n margin: 0\n padding: 0\n\n// Responsiveness\n\n=from($device)\n @media screen and (min-width: $device)\n @content\n\n=until($device)\n @media screen and (max-width: $device - 1px)\n @content\n\n=between($from, $until)\n @media screen and (min-width: $from) and (max-width: $until - 1px)\n @content\n\n=mobile\n @media screen and (max-width: $tablet - 1px)\n @content\n\n=tablet\n @media screen and (min-width: $tablet), print\n @content\n\n=tablet-only\n @media screen and (min-width: $tablet) and (max-width: $desktop - 1px)\n @content\n\n=touch\n @media screen and (max-width: $desktop - 1px)\n @content\n\n=desktop\n @media screen and (min-width: $desktop)\n @content\n\n=desktop-only\n @if $widescreen-enabled\n @media screen and (min-width: $desktop) and (max-width: $widescreen - 1px)\n @content\n\n=until-widescreen\n @if $widescreen-enabled\n @media screen and (max-width: $widescreen - 1px)\n @content\n\n=widescreen\n @if $widescreen-enabled\n @media screen and (min-width: $widescreen)\n @content\n\n=widescreen-only\n @if $widescreen-enabled and $fullhd-enabled\n @media screen and (min-width: $widescreen) and (max-width: $fullhd - 1px)\n @content\n\n=until-fullhd\n @if $fullhd-enabled\n @media screen and (max-width: $fullhd - 1px)\n @content\n\n=fullhd\n @if $fullhd-enabled\n @media screen and (min-width: $fullhd)\n @content\n\n=breakpoint($name)\n $breakpoint: map-get($breakpoints, $name)\n @if $breakpoint\n $from: map-get($breakpoint, \"from\")\n $until: map-get($breakpoint, \"until\")\n @if $from and $until\n +between($from, $until)\n @content\n @else if $from\n +from($from)\n @content\n @else if $until\n +until($until)\n @content\n\n=ltr\n @if not $rtl\n @content\n\n=rtl\n @if $rtl\n @content\n\n=ltr-property($property, $spacing, $right: true)\n $normal: if($right, \"right\", \"left\")\n $opposite: if($right, \"left\", \"right\")\n @if $rtl\n #{$property}-#{$opposite}: $spacing\n @else\n #{$property}-#{$normal}: $spacing\n\n=ltr-position($spacing, $right: true)\n $normal: if($right, \"right\", \"left\")\n $opposite: if($right, \"left\", \"right\")\n @if $rtl\n #{$opposite}: $spacing\n @else\n #{$normal}: $spacing\n\n// Placeholders\n\n=unselectable\n -webkit-touch-callout: none\n -webkit-user-select: none\n -moz-user-select: none\n -ms-user-select: none\n user-select: none\n\n=arrow($color: transparent)\n border: 3px solid $color\n border-radius: 2px\n border-right: 0\n border-top: 0\n content: \" \"\n display: block\n height: 0.625em\n margin-top: -0.4375em\n pointer-events: none\n position: absolute\n top: 50%\n transform: rotate(-45deg)\n transform-origin: center\n width: 0.625em\n\n=block($spacing: $block-spacing)\n &:not(:last-child)\n margin-bottom: $spacing\n\n=delete\n +unselectable\n -moz-appearance: none\n -webkit-appearance: none\n background-color: bulmaRgba($scheme-invert, 0.2)\n border: none\n border-radius: $radius-rounded\n cursor: pointer\n pointer-events: auto\n display: inline-block\n flex-grow: 0\n flex-shrink: 0\n font-size: 0\n height: 20px\n max-height: 20px\n max-width: 20px\n min-height: 20px\n min-width: 20px\n outline: none\n position: relative\n vertical-align: top\n width: 20px\n &::before,\n &::after\n background-color: $scheme-main\n content: \"\"\n display: block\n left: 50%\n position: absolute\n top: 50%\n transform: translateX(-50%) translateY(-50%) rotate(45deg)\n transform-origin: center center\n &::before\n height: 2px\n width: 50%\n &::after\n height: 50%\n width: 2px\n &:hover,\n &:focus\n background-color: bulmaRgba($scheme-invert, 0.3)\n &:active\n background-color: bulmaRgba($scheme-invert, 0.4)\n // Sizes\n &.is-small\n height: 16px\n max-height: 16px\n max-width: 16px\n min-height: 16px\n min-width: 16px\n width: 16px\n &.is-medium\n height: 24px\n max-height: 24px\n max-width: 24px\n min-height: 24px\n min-width: 24px\n width: 24px\n &.is-large\n height: 32px\n max-height: 32px\n max-width: 32px\n min-height: 32px\n min-width: 32px\n width: 32px\n\n=loader\n animation: spinAround 500ms infinite linear\n border: 2px solid $grey-lighter\n border-radius: $radius-rounded\n border-right-color: transparent\n border-top-color: transparent\n content: \"\"\n display: block\n height: 1em\n position: relative\n width: 1em\n\n=overlay($offset: 0)\n bottom: $offset\n left: $offset\n position: absolute\n right: $offset\n top: $offset\n" }, { "path": "guide/style/bulma-prefers-dark/LICENSE", "content": "MIT License\n\nCopyright (c) 2019 James Loh\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 all\ncopies 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 THE\nSOFTWARE.\n" }, { "path": "guide/style/bulma-prefers-dark/bulma-prefers-dark.sass", "content": "@charset \"utf-8\"\n/*! Bulma Prefers Dark | MIT License | github.com/jloh/bulma-prefers-dark */\n\n@import \"sass/utilities/_all\"\n+prefers-scheme(dark)\n @import \"sass/base/_all\"\n @import \"sass/elements/_all\"\n @import \"sass/components/_all\"\n @import \"sass/layout/_all\"\n" }, { "path": "guide/style/bulma-prefers-dark/sass/base/_all.sass", "content": "@charset \"utf-8\"\n\n@import \"generic.sass\"\n@import \"helpers.sass\"\n" }, { "path": "guide/style/bulma-prefers-dark/sass/base/generic.sass", "content": "$body-background-color-dark: $body-background-dark !default\n$body-color-dark: $text-dark !default\n\n$hr-background-color-dark: $background-dark !default\n\n$strong-color-dark: $text-strong-dark !default\n\nhtml\n background-color: $body-background-color-dark\n\nbody\n color: $body-color-dark\n\n// Inline\n\na\n color: $link-dark\n &:hover\n color: $link-hover-dark\n\ncode\n background-color: $code-background-dark\n color: $code-dark\n\nhr\n background-color: $hr-background-color-dark\n\nstrong\n color: $strong-color-dark\n\n// Block\n\npre\n background-color: $pre-background-dark\n color: $pre-dark\n\ntable\n th\n color: $text-strong-dark\n" }, { "path": "guide/style/bulma-prefers-dark/sass/base/helpers.sass", "content": "@each $name, $pair in $colors\n $color: nth($pair, 1)\n .has-text-#{$name}-dark\n color: $color !important\n a.has-text-#{$name}-dark\n &:hover,\n &:focus\n color: lighten($color, 10%) !important\n .has-background-#{$name}-dark\n background-color: $color !important\n\n@each $name, $shade in $shades\n .has-text-#{$name}-dark\n color: $shade !important\n .has-background-#{$name}-dark\n background-color: $shade !important\n" }, { "path": "guide/style/bulma-prefers-dark/sass/components/_all.sass", "content": "@charset \"utf-8\"\n\n@import \"breadcrumb.sass\"\n@import \"card.sass\"\n@import \"dropdown.sass\"\n@import \"list.sass\"\n@import \"media.sass\"\n@import \"menu.sass\"\n@import \"message.sass\"\n@import \"modal.sass\"\n@import \"navbar.sass\"\n@import \"pagination.sass\"\n@import \"panel.sass\"\n@import \"tabs.sass\"\n" }, { "path": "guide/style/bulma-prefers-dark/sass/components/breadcrumb.sass", "content": "$breadcrumb-item-color-dark: $link-dark !default\n$breadcrumb-item-hover-color-dark: $link-hover-dark !default\n$breadcrumb-item-active-color-dark: $text-strong-dark !default\n\n$breadcrumb-item-separator-color-dark: $grey-dark !default\n\n.breadcrumb\n a\n color: $breadcrumb-item-color-dark\n &:hover\n color: $breadcrumb-item-hover-color-dark\n li\n &.is-active\n a\n color: $breadcrumb-item-active-color-dark\n & + li::before\n color: $breadcrumb-item-separator-color-dark\n" }, { "path": "guide/style/bulma-prefers-dark/sass/components/card.sass", "content": "$card-color-dark: $text-dark !default\n$card-background-color-dark: $black !default\n$card-shadow-dark: 0 2px 3px rgba($white, 0.1), 0 0 0 1px rgba($white, 0.1) !default\n\n$card-header-color-dark: $text-strong-dark !default\n$card-header-shadow-dark: 0 1px 2px rgba($white, 0.1) !default\n\n$card-footer-border-top-dark: 1px solid $border-dark !default\n\n.card\n background-color: $card-background-color-dark\n box-shadow: $card-shadow-dark\n color: $card-color-dark\n\n.card-header\n box-shadow: $card-header-shadow-dark\n\n.card-header-title\n color: $card-header-color-dark\n\n.card-footer\n border-top: $card-footer-border-top-dark\n\n.card-footer-item\n &:not(:last-child)\n border-right: $card-footer-border-top-dark\n" }, { "path": "guide/style/bulma-prefers-dark/sass/components/dropdown.sass", "content": "$dropdown-content-background-color-dark: $black !default\n$dropdown-content-arrow: $link-dark !default\n$dropdown-content-shadow-dark: 0 2px 3px rgba($white, 0.1), 0 0 0 1px rgba($white, 0.1) !default\n\n$dropdown-item-color-dark: $grey-light !default\n$dropdown-item-hover-color-dark: $white !default\n$dropdown-item-hover-background-color-dark: $background-dark !default\n$dropdown-item-active-color-dark: $link-invert-dark !default\n$dropdown-item-active-background-color-dark: $link-dark !default\n\n$dropdown-divider-background-color-dark: $border-dark !default\n\n.dropdown-content\n background-color: $dropdown-content-background-color-dark\n box-shadow: $dropdown-content-shadow-dark\n\n.dropdown-item\n color: $dropdown-item-color-dark\n\na.dropdown-item,\nbutton.dropdown-item\n &:hover\n background-color: $dropdown-item-hover-background-color-dark\n color: $dropdown-item-hover-color-dark\n &.is-active\n background-color: $dropdown-item-active-background-color-dark\n color: $dropdown-item-active-color-dark\n\n.dropdown-divider\n background-color: $dropdown-divider-background-color-dark\n" }, { "path": "guide/style/bulma-prefers-dark/sass/components/list.sass", "content": "$list-background-color-dark: $black !default\n$list-shadow-dark: 0 2px 3px rgba($white, 0.1), 0 0 0 1px rgba($white, 0.1) !default\n\n$list-item-border-dark: 1px solid $border-dark !default\n$list-item-color-dark: $text-dark !default\n$list-item-active-background-color-dark: $link-dark !default\n$list-item-active-color-dark: $link-invert-dark !default\n$list-item-hover-background-color-dark: $background-dark !default\n\n.list\n background-color: $list-background-color-dark\n box-shadow: $list-shadow-dark\n // &.is-hoverable > .list-item:hover:not(.is-active)\n // background-color: $list-item-hover-background-color-dark\n // cursor: pointer\n\n.list-item\n &:not(a)\n color: $list-item-color-dark\n &:not(:last-child)\n border-bottom: $list-item-border-dark\n &.is-active\n background-color: $list-item-active-background-color-dark\n color: $list-item-active-color-dark\n\na.list-item\n background-color: $list-item-hover-background-color-dark\n" }, { "path": "guide/style/bulma-prefers-dark/sass/components/media.sass", "content": ".media\n .media\n border-top: 1px solid rgba($border-dark, 0.5)\n & + .media\n border-top: 1px solid rgba($border-dark, 0.5)\n" }, { "path": "guide/style/bulma-prefers-dark/sass/components/menu.sass", "content": "$menu-item-color-dark: $text-dark !default\n$menu-item-hover-color-dark: $text-strong-dark !default\n$menu-item-hover-background-color-dark: $background-dark !default\n$menu-item-active-color-dark: $link-invert-dark !default\n$menu-item-active-background-color-dark: $link-dark !default\n\n$menu-list-border-left-dark: 1px solid $border-dark !default\n\n.menu-list\n a\n color: $menu-item-color-dark\n &:hover\n background-color: $menu-item-hover-background-color-dark\n color: $menu-item-hover-color-dark\n // Modifiers\n &.is-active\n background-color: $menu-item-active-background-color-dark\n color: $menu-item-active-color-dark\n li\n ul\n border-left: $menu-list-border-left-dark\n" }, { "path": "guide/style/bulma-prefers-dark/sass/components/message.sass", "content": "$message-background-color-dark: $background-dark !default\n\n$message-header-background-color-dark: $text-dark !default\n$message-header-color-dark: $text-invert-dark !default\n\n$message-body-border-color-dark: $border-dark !default\n$message-body-color-dark: $text-dark !default\n\n$message-body-pre-background-color-dark: $black !default\n\n.message\n background-color: $message-background-color-dark\n // Colors\n @each $name, $pair in $colors\n $color: nth($pair, 1)\n $color-invert: nth($pair, 2)\n &.is-#{$name}\n background-color: $background-dark\n .message-header\n background-color: $color\n color: $color-invert\n .message-body\n border-color: $color\n color: $text-dark\n\n // Dark Colors\n @each $name, $pair in $colors\n $color: nth($pair, 1)\n $color-invert: nth($pair, 2)\n &.is-#{$name}-dark\n background-color: $background-dark\n .message-header\n background-color: $color\n color: $color-invert\n .message-body\n border-color: $color\n color: $text-dark\n\n.message-header\n background-color: $message-header-background-color-dark\n color: $message-header-color-dark\n\n.message-body\n border-color: $message-body-border-color-dark\n color: $message-body-color-dark\n code,\n pre\n background-color: $message-body-pre-background-color-dark\n" }, { "path": "guide/style/bulma-prefers-dark/sass/components/modal.sass", "content": "$modal-background-background-color-dark: rgba($white, 0.86) !default\n\n$modal-card-head-background-color-dark: $background-dark !default\n$modal-card-head-border-bottom-dark: 1px solid $border-dark !default\n\n$modal-card-title-color-dark: $text-strong-dark !default\n\n$modal-card-foot-border-top-dark: 1px solid $border-dark !default\n\n$modal-card-body-background-color-dark: $white !default\n\n.modal-background\n background-color: $modal-background-background-color-dark\n\n.modal-card-head,\n.modal-card-foot\n background-color: $modal-card-head-background-color-dark\n\n.modal-card-head\n border-bottom: $modal-card-head-border-bottom-dark\n\n.modal-card-title\n color: $modal-card-title-color-dark\n\n.modal-card-foot\n border-top: $modal-card-foot-border-top-dark\n\n.modal-card-body\n +overflow-touch\n background-color: $modal-card-body-background-color-dark\n" }, { "path": "guide/style/bulma-prefers-dark/sass/components/navbar.sass", "content": "$navbar-background-color-dark: $body-background-dark !default\n$navbar-box-shadow-size: 0 2px 0 0 !default\n$navbar-box-shadow-color-dark: $background-dark !default\n\n$navbar-item-color-dark: $grey-light !default\n$navbar-item-hover-color-dark: $link-dark !default\n$navbar-item-hover-background-color-dark: $black-bis !default\n$navbar-item-active-color-dark: $white !default\n\n$navbar-burger-color-dark: $navbar-item-color-dark !default\n\n$navbar-tab-hover-border-bottom-color-dark: $link-dark !default\n$navbar-tab-active-color-dark: $link-dark !default\n$navbar-tab-active-border-bottom-color-dark: $link-dark !default\n\n$navbar-dropdown-background-color-dark: $black !default\n$navbar-dropdown-border-top-dark: 2px solid $border-dark !default\n$navbar-dropdown-arrow-dark: $link-dark !default\n\n$navbar-dropdown-boxed-shadow-dark: 0 8px 8px rgba($white, 0.1), 0 0 0 1px rgba($white, 0.1) !default\n\n$navbar-dropdown-item-hover-color-dark: $white !default\n$navbar-dropdown-item-hover-background-color-dark: $background-dark !default\n$navbar-dropdown-item-active-color-dark: $link-dark !default\n$navbar-dropdown-item-active-background-color-dark: $background-dark !default\n\n$navbar-divider-background-color-dark: $background-dark !default\n\n$navbar-bottom-box-shadow-size: 0 -2px 0 0 !default\n\n$navbar-breakpoint: $desktop !default\n\n.navbar\n background-color: $navbar-background-color-dark\n @each $name, $pair in $colors\n $color: darken(nth($pair, 1), 10%)\n $color-invert: nth($pair, 2)\n &.is-#{$name}\n background-color: $color\n color: $color-invert\n .navbar-brand\n & > .navbar-item,\n .navbar-link\n color: $color-invert\n & > a.navbar-item,\n .navbar-link\n &:hover,\n &.is-active\n background-color: darken($color, 5%)\n color: $color-invert\n .navbar-link\n &::after\n border-color: $color-invert\n .navbar-burger\n color: $color-invert\n +from($navbar-breakpoint)\n .navbar-start,\n .navbar-end\n & > .navbar-item,\n .navbar-link\n color: $color-invert\n & > a.navbar-item,\n .navbar-link\n &:hover,\n &.is-active\n background-color: darken($color, 5%)\n color: $color-invert\n .navbar-link\n &::after\n border-color: $color-invert\n .navbar-item.has-dropdown:hover .navbar-link,\n .navbar-item.has-dropdown.is-active .navbar-link\n background-color: darken($color, 5%)\n color: $color-invert\n .navbar-dropdown\n a.navbar-item\n &.is-active\n background-color: $color\n color: $color-invert\n // Colors Dark\n @each $name, $pair in $colors\n $color: nth($pair, 1)\n $color-invert: nth($pair, 2)\n &.is-#{$name}-dark\n background-color: $color\n color: $color-invert\n .navbar-brand\n & > .navbar-item,\n .navbar-link\n color: $color-invert\n & > a.navbar-item,\n .navbar-link\n &:hover,\n &.is-active\n background-color: darken($color, 5%)\n color: $color-invert\n .navbar-link\n &::after\n border-color: $color-invert\n .navbar-burger\n color: $color-invert\n +from($navbar-breakpoint)\n .navbar-start,\n .navbar-end\n & > .navbar-item,\n .navbar-link\n color: $color-invert\n & > a.navbar-item,\n .navbar-link\n &:hover,\n &.is-active\n background-color: darken($color, 5%)\n color: $color-invert\n .navbar-link\n &::after\n border-color: $color-invert\n .navbar-item.has-dropdown:hover .navbar-link,\n .navbar-item.has-dropdown.is-active .navbar-link\n background-color: darken($color, 5%)\n color: $color-invert\n .navbar-dropdown\n a.navbar-item\n &.is-active\n background-color: $color\n color: $color-invert\n &.has-shadow\n box-shadow: $navbar-box-shadow-size $navbar-box-shadow-color-dark\n &.is-fixed-bottom\n &.has-shadow\n box-shadow: $navbar-bottom-box-shadow-size $navbar-box-shadow-color-dark\n\n.navbar-burger\n color: $navbar-burger-color-dark\n\n.navbar-item,\n.navbar-link\n color: $navbar-item-color-dark\n\na.navbar-item,\n.navbar-link\n &:hover,\n &.is-active\n background-color: $navbar-item-hover-background-color-dark\n color: $navbar-item-hover-color-dark\n\n.navbar-item\n &:hover\n border-bottom-color: $navbar-tab-hover-border-bottom-color-dark\n &.is-active\n border-bottom-color: $navbar-tab-active-border-bottom-color-dark\n color: $navbar-tab-active-color-dark\n\n.navbar-link:not(.is-arrowless)\n &::after\n border-color: $navbar-dropdown-arrow-dark\n\n.navbar-divider\n background-color: $navbar-divider-background-color-dark\n\n+until($navbar-breakpoint)\n .navbar-menu\n background-color: $navbar-background-color-dark\n box-shadow: 0 8px 16px rgba($white, 0.1)\n // Fixed navbar\n .navbar\n &.is-fixed-bottom-touch\n &.has-shadow\n box-shadow: 0 -2px 3px rgba($white, 0.1)\n\n+from($navbar-breakpoint)\n .navbar\n &.is-transparent\n .navbar-dropdown\n a.navbar-item\n &:hover\n background-color: $navbar-dropdown-item-hover-background-color-dark\n color: $navbar-dropdown-item-hover-color-dark\n &.is-active\n background-color: $navbar-dropdown-item-active-background-color-dark\n color: $navbar-dropdown-item-active-color-dark\n .navbar-item\n &.has-dropdown-up\n .navbar-dropdown\n border-bottom: $navbar-dropdown-border-top-dark\n box-shadow: 0 -8px 8px rgba($white, 0.1)\n .navbar-dropdown\n background-color: $navbar-dropdown-background-color-dark\n border-top: $navbar-dropdown-border-top-dark\n box-shadow: 0 8px 8px rgba($white, 0.1)\n a.navbar-item\n &:hover\n background-color: $navbar-dropdown-item-hover-background-color-dark\n color: $navbar-dropdown-item-hover-color-dark\n &.is-active\n background-color: $navbar-dropdown-item-active-background-color-dark\n color: $navbar-dropdown-item-active-color-dark\n .navbar.is-spaced &,\n &.is-boxed\n box-shadow: $navbar-dropdown-boxed-shadow-dark\n // Fixed navbar\n .navbar\n &.is-fixed-bottom-desktop\n &.has-shadow\n box-shadow: 0 -2px 3px rgba($white, 0.1)\n // Hover/Active states\n a.navbar-item,\n .navbar-link\n &.is-active\n color: $navbar-item-active-color-dark\n .navbar-item.has-dropdown\n &:hover,\n &.is-active\n .navbar-link\n background-color: $navbar-item-hover-background-color-dark\n" }, { "path": "guide/style/bulma-prefers-dark/sass/components/pagination.sass", "content": "$pagination-color-dark: $grey-lighter !default\n$pagination-border-color-dark: $grey-darker !default\n\n$pagination-hover-color-dark: $link-hover-dark !default\n$pagination-hover-border-color-dark: $link-hover-border-dark !default\n\n$pagination-focus-color-dark: $link-focus-dark !default\n$pagination-focus-border-color-dark: $link-focus-border-dark !default\n\n$pagination-active-color-dark: $link-active-dark !default\n$pagination-active-border-color-dark: $link-active-border-dark !default\n\n$pagination-disabled-color-dark: $grey !default\n$pagination-disabled-background-color-dark: $grey-darker !default\n$pagination-disabled-border-color-dark: $grey-darker !default\n\n$pagination-current-color-dark: $link-invert-dark !default\n$pagination-current-background-color-dark: $link-dark !default\n$pagination-current-border-color-dark: $link-dark !default\n\n$pagination-ellipsis-color-dark: $grey-dark !default\n\n$pagination-shadow-inset-dark: inset 0 1px 2px rgba($white, 0.2)\n\n.pagination-previous,\n.pagination-next,\n.pagination-link\n border-color: $pagination-border-color-dark\n color: $pagination-color-dark\n &:hover\n border-color: $pagination-hover-border-color-dark\n color: $pagination-hover-color-dark\n &:focus\n border-color: $pagination-focus-border-color-dark\n &:active\n box-shadow: $pagination-shadow-inset-dark\n &[disabled]\n background-color: $pagination-disabled-background-color-dark\n border-color: $pagination-disabled-border-color-dark\n color: $pagination-disabled-color-dark\n\n.pagination-link\n &.is-current\n background-color: $pagination-current-background-color-dark\n border-color: $pagination-current-border-color-dark\n color: $pagination-current-color-dark\n\n.pagination-ellipsis\n color: $pagination-ellipsis-color-dark\n" }, { "path": "guide/style/bulma-prefers-dark/sass/components/panel.sass", "content": "$panel-item-border-dark: 1px solid $border-dark !default\n\n$panel-heading-background-color-dark: $background-dark !default\n$panel-heading-color-dark: $text-strong-dark !default\n\n$panel-tab-border-bottom-dark: 1px solid $border-dark !default\n$panel-tab-active-border-bottom-color-dark: $link-active-border-dark !default\n$panel-tab-active-color-dark: $link-active-dark !default\n\n$panel-list-item-color-dark: $text-dark !default\n$panel-list-item-hover-color-dark: $link-dark !default\n\n$panel-block-color-dark: $text-strong-dark !default\n$panel-block-hover-background-color-dark: $background-dark !default\n$panel-block-active-border-left-color-dark: $link-dark !default\n$panel-block-active-color-dark: $link-active-dark !default\n$panel-block-active-icon-color-dark: $link-dark !default\n\n.panel-heading,\n.panel-tabs,\n.panel-block\n border-bottom: $panel-item-border-dark\n border-left: $panel-item-border-dark\n border-right: $panel-item-border-dark\n &:first-child\n border-top: $panel-item-border-dark\n\n.panel-heading\n background-color: $panel-heading-background-color-dark\n color: $panel-heading-color-dark\n\n.panel-tabs\n a\n border-bottom: $panel-tab-border-bottom-dark\n // Modifiers\n &.is-active\n border-bottom-color: $panel-tab-active-border-bottom-color-dark\n color: $panel-tab-active-color-dark\n\n.panel-list\n a\n color: $panel-list-item-color-dark\n &:hover\n color: $panel-list-item-hover-color-dark\n\n.panel-block\n color: $panel-block-color-dark\n &.is-active\n border-left-color: $panel-block-active-border-left-color-dark\n color: $panel-block-active-color-dark\n .panel-icon\n color: $panel-block-active-icon-color-dark\n\na.panel-block,\nlabel.panel-block\n &:hover\n background-color: $panel-block-hover-background-color-dark\n" }, { "path": "guide/style/bulma-prefers-dark/sass/components/tabs.sass", "content": "$tabs-border-bottom-color-dark: $border-dark !default\n$tabs-link-color-dark: $text-dark !default\n$tabs-link-hover-border-bottom-color-dark: $text-strong-dark !default\n$tabs-link-hover-color-dark: $text-strong-dark !default\n$tabs-link-active-border-bottom-color-dark: $link-dark !default\n$tabs-link-active-color-dark: $link-dark !default\n\n$tabs-boxed-link-hover-background-color-dark: $background-dark !default\n$tabs-boxed-link-hover-border-bottom-color-dark: $border-dark !default\n\n$tabs-boxed-link-active-background-color-dark: $black !default\n$tabs-boxed-link-active-border-color-dark: $border-dark !default\n\n$tabs-toggle-link-border-color-dark: $border-dark !default\n$tabs-toggle-link-hover-background-color-dark: $background-dark !default\n$tabs-toggle-link-hover-border-color-dark: $border-hover-dark !default\n$tabs-toggle-link-active-background-color-dark: $link-dark !default\n$tabs-toggle-link-active-border-color-dark: $link-dark !default\n$tabs-toggle-link-active-color-dark: $link-invert-dark !default\n\n.tabs\n a\n border-bottom-color: $tabs-border-bottom-color-dark\n color: $tabs-link-color-dark\n &:hover\n border-bottom-color: $tabs-link-hover-border-bottom-color-dark\n color: $tabs-link-hover-color-dark\n li\n &.is-active\n a\n border-bottom-color: $tabs-link-active-border-bottom-color-dark\n color: $tabs-link-active-color-dark\n ul\n border-bottom-color: $tabs-border-bottom-color-dark\n // Styles\n &.is-boxed\n a\n &:hover\n background-color: $tabs-boxed-link-hover-background-color-dark\n border-bottom-color: $tabs-boxed-link-hover-border-bottom-color-dark\n li\n &.is-active\n a\n background-color: $tabs-boxed-link-active-background-color-dark\n border-color: $tabs-boxed-link-active-border-color-dark\n &.is-toggle\n a\n border-color: $tabs-toggle-link-border-color-dark\n &:hover\n background-color: $tabs-toggle-link-hover-background-color-dark\n border-color: $tabs-toggle-link-hover-border-color-dark\n li\n &.is-active\n a\n background-color: $tabs-toggle-link-active-background-color-dark\n border-color: $tabs-toggle-link-active-border-color-dark\n color: $tabs-toggle-link-active-color-dark\n" }, { "path": "guide/style/bulma-prefers-dark/sass/elements/_all.sass", "content": "@charset \"utf-8\"\n\n@import \"box.sass\"\n@import \"button.sass\"\n@import \"content.sass\"\n@import \"form.sass\"\n@import \"notification.sass\"\n@import \"progress.sass\"\n@import \"table.sass\"\n@import \"tag.sass\"\n@import \"title.sass\"\n\n@import \"other.sass\"\n" }, { "path": "guide/style/bulma-prefers-dark/sass/elements/box.sass", "content": "$box-color-dark: $text-dark !default\n$box-background-color-dark: $black !default\n$box-shadow-dark: 0 2px 3px rgba($white, 0.1), 0 0 0 1px rgba($white, 0.1) !default\n\n$box-link-hover-shadow-dark: 0 2px 3px rgba($white, 0.1), 0 0 0 1px $link-dark !default\n$box-link-active-shadow-dark: inset 0 1px 2px rgba($white, 0.2), 0 0 0 1px $link-dark !default\n\n.box\n background-color: $box-background-color-dark\n box-shadow: $box-shadow-dark\n color: $box-color-dark\n\na.box\n &:hover,\n &:focus\n box-shadow: $box-link-hover-shadow-dark\n &:active\n box-shadow: $box-link-active-shadow-dark\n" }, { "path": "guide/style/bulma-prefers-dark/sass/elements/button.sass", "content": "$button-color-dark: $grey-lighter !default\n$button-background-color-dark: $black !default\n\n$button-border-color-dark: $grey-darker !default\n\n$button-hover-color-dark: $link-hover-dark !default\n$button-hover-border-color-dark: $link-hover-border-dark !default\n\n$button-focus-color-dark: $link-focus-dark !default\n$button-focus-border-color-dark: $link-focus-border-dark !default\n$button-focus-box-shadow-size: 0 0 0 0.125em !default\n$button-focus-box-shadow-color-dark: rgba($link-dark, 0.25) !default\n\n$button-active-color-dark: $link-active-dark !default\n$button-active-border-color-dark: $link-active-border-dark !default\n\n$button-text-color-dark: $text-dark !default\n$button-text-hover-background-color-dark: $background-dark !default\n$button-text-hover-color-dark: $text-strong-dark !default\n\n$button-disabled-background-color-dark: $black !default\n$button-disabled-border-color-dark: $grey-darker !default\n\n$button-static-color-dark: $grey !default\n$button-static-background-color-dark: $white-ter !default\n$button-static-border-color-dark: $grey-darker !default\n\n.button\n background-color: $button-background-color-dark\n border-color: $button-border-color-dark\n color: $button-color-dark\n // States\n &:hover,\n &.is-hovered\n border-color: $button-hover-border-color-dark\n color: $button-hover-color-dark\n &:focus,\n &.is-focused\n border-color: $button-focus-border-color-dark\n color: $button-focus-color-dark\n &:not(:active)\n box-shadow: $button-focus-box-shadow-size $button-focus-box-shadow-color-dark\n &:active,\n &.is-active\n border-color: $button-active-border-color-dark\n color: $button-active-color-dark\n // Colors\n &.is-text\n color: $button-text-color-dark\n &:hover,\n &.is-hovered,\n &:focus,\n &.is-focused\n background-color: $button-text-hover-background-color-dark\n color: $button-text-hover-color-dark\n &:active,\n &.is-active\n background-color: darken($button-text-hover-background-color-dark, 5%)\n color: $button-text-hover-color-dark\n // Colors\n @each $name, $pair in $colors\n $color: darken(nth($pair, 1), 10%)\n $color-invert: nth($pair, 2)\n &.is-#{$name}\n background-color: $color\n border-color: transparent\n color: $color-invert\n &:hover,\n &.is-hovered\n background-color: darken($color, 2.5%)\n border-color: transparent\n color: $color-invert\n &:focus,\n &.is-focused\n border-color: transparent\n color: $color-invert\n &:not(:active)\n box-shadow: $button-focus-box-shadow-size rgba($color, 0.25)\n &:active,\n &.is-active\n background-color: darken($color, 5%)\n border-color: transparent\n color: $color-invert\n &[disabled],\n fieldset[disabled] &\n background-color: $color\n border-color: transparent\n box-shadow: none\n &.is-inverted\n background-color: $color-invert\n color: $color\n &:hover\n background-color: darken($color-invert, 5%)\n &[disabled],\n fieldset[disabled] &\n background-color: $color-invert\n border-color: transparent\n box-shadow: none\n color: $color\n &.is-loading\n &::after\n border-color: transparent transparent $color-invert $color-invert !important\n &.is-outlined\n background-color: transparent\n border-color: $color\n color: $color\n &:hover,\n &:focus\n background-color: $color\n border-color: $color\n color: $color-invert\n &.is-loading\n &::after\n border-color: transparent transparent $color $color !important\n &[disabled],\n fieldset[disabled] &\n background-color: transparent\n border-color: $color\n box-shadow: none\n color: $color\n &.is-inverted.is-outlined\n background-color: transparent\n border-color: $color-invert\n color: $color-invert\n &:hover,\n &:focus\n background-color: $color-invert\n color: $color\n &[disabled],\n fieldset[disabled] &\n background-color: transparent\n border-color: $color-invert\n box-shadow: none\n color: $color-invert\n // Colors Dark\n @each $name, $pair in $colors\n $color: nth($pair, 1)\n $color-invert: nth($pair, 2)\n &.is-#{$name}-dark\n background-color: $color\n border-color: transparent\n color: $color-invert\n &:hover,\n &.is-hovered\n background-color: darken($color, 2.5%)\n border-color: transparent\n color: $color-invert\n &:focus,\n &.is-focused\n border-color: transparent\n color: $color-invert\n &:not(:active)\n box-shadow: $button-focus-box-shadow-size rgba($color, 0.25)\n &:active,\n &.is-active\n background-color: darken($color, 5%)\n border-color: transparent\n color: $color-invert\n &[disabled],\n fieldset[disabled] &\n background-color: $color\n border-color: transparent\n box-shadow: none\n &.is-inverted\n background-color: $color-invert\n color: $color\n &:hover\n background-color: darken($color-invert, 5%)\n &[disabled],\n fieldset[disabled] &\n background-color: $color-invert\n border-color: transparent\n box-shadow: none\n color: $color\n &.is-loading\n &::after\n border-color: transparent transparent $color-invert $color-invert !important\n &.is-outlined\n background-color: transparent\n border-color: $color\n color: $color\n &:hover,\n &:focus\n background-color: $color\n border-color: $color\n color: $color-invert\n &.is-loading\n &::after\n border-color: transparent transparent $color $color !important\n &[disabled],\n fieldset[disabled] &\n background-color: transparent\n border-color: $color\n box-shadow: none\n color: $color\n &.is-inverted.is-outlined\n background-color: transparent\n border-color: $color-invert\n color: $color-invert\n &:hover,\n &:focus\n background-color: $color-invert\n color: $color\n &[disabled],\n fieldset[disabled] &\n background-color: transparent\n border-color: $color-invert\n box-shadow: none\n color: $color-invert\n // Modifiers\n &[disabled],\n fieldset[disabled] &\n background-color: $button-disabled-background-color-dark\n border-color: $button-disabled-border-color-dark\n &.is-static\n background-color: $button-static-background-color-dark\n border-color: $button-static-border-color-dark\n color: $button-static-color-dark\n" }, { "path": "guide/style/bulma-prefers-dark/sass/elements/content.sass", "content": "$content-heading-color-dark: $text-strong-dark !default\n\n$content-blockquote-background-color-dark: $background-dark !default\n$content-blockquote-border-left-dark: 5px solid $border-dark !default\n\n$content-table-cell-border-dark: 1px solid $border-dark !default\n$content-table-cell-heading-color-dark: $text-strong-dark !default\n$content-table-head-cell-color-dark: $text-strong-dark !default\n$content-table-foot-cell-color-dark: $text-strong-dark !default\n\n.content\n h1,\n h2,\n h3,\n h4,\n h5,\n h6\n color: $content-heading-color-dark\n blockquote\n background-color: $content-blockquote-background-color-dark\n border-left: $content-blockquote-border-left-dark\n table\n td,\n th\n border: $content-table-cell-border-dark\n th\n color: $content-table-cell-heading-color-dark\n thead\n td,\n th\n color: $content-table-head-cell-color-dark\n tfoot\n td,\n th\n color: $content-table-foot-cell-color-dark\n" }, { "path": "guide/style/bulma-prefers-dark/sass/elements/form.sass", "content": "$input-color-dark: $grey-lighter !default\n$input-background-color-dark: $black !default\n$input-border-color-dark: $grey-darker !default\n$input-shadow-dark: inset 0 1px 2px rgba($white, 0.1) !default\n$input-placeholder-color-dark: rgba($input-color-dark, 0.3) !default\n\n$input-hover-color-dark: $grey-lighter !default\n$input-hover-border-color-dark: $grey-dark !default\n\n$input-focus-color-dark: $grey-lighter !default\n$input-focus-border-color-dark: $link-dark !default\n$input-focus-box-shadow-size: 0 0 0 0.125em !default\n$input-focus-box-shadow-color-dark: rgba($link-dark, 0.25) !default\n\n$input-disabled-color-dark: $text-dark !default\n$input-disabled-background-color-dark: $background-dark !default\n$input-disabled-border-color-dark: $background-dark !default\n$input-disabled-placeholder-color-dark: rgba($input-disabled-color-dark, 0.3) !default\n\n$input-arrow-dark: $link-dark !default\n\n$input-icon-color-dark: $grey-darker !default\n\n$file-border-color-dark: $border-dark !default\n\n$file-cta-background-color-dark: $black-ter !default\n$file-cta-color-dark: $grey-light !default\n$file-cta-hover-color-dark: $grey-lighter !default\n$file-cta-active-color-dark: $grey-lighter !default\n\n$file-name-border-color-dark: $border-dark !default\n\n$label-color-dark: $grey-lighter !default\n\n=input\n background-color: $input-background-color-dark\n border-color: $input-border-color-dark\n color: $input-color-dark\n +placeholder\n color: $input-placeholder-color-dark\n &:hover,\n &.is-hovered\n border-color: $input-hover-border-color-dark\n &:focus,\n &.is-focused,\n &:active,\n &.is-active\n border-color: $input-focus-border-color-dark\n box-shadow: $input-focus-box-shadow-size $input-focus-box-shadow-color-dark\n &[disabled],\n fieldset[disabled] &\n background-color: $input-disabled-background-color-dark\n border-color: $input-disabled-border-color-dark\n color: $input-disabled-color-dark\n +placeholder\n color: $input-disabled-placeholder-color-dark\n\n.input,\n.textarea\n +input\n box-shadow: $input-shadow-dark\n // Colors\n @each $name, $pair in $colors\n $color: darken(nth($pair, 1), 10%)\n &.is-#{$name}\n border-color: $color\n &:focus,\n &.is-focused,\n &:active,\n &.is-active\n box-shadow: $input-focus-box-shadow-size rgba($color, 0.25)\n // Colors Dark\n @each $name, $pair in $colors\n $color: nth($pair, 1)\n &.is-#{$name}-dark\n border-color: $color\n &:focus,\n &.is-focused,\n &:active,\n &.is-active\n box-shadow: $input-focus-box-shadow-size rgba($color, 0.25)\n\n.checkbox,\n.radio\n &:hover\n color: $input-hover-color-dark\n &[disabled],\n fieldset[disabled] &\n color: $input-disabled-color-dark\n\n.select\n &:not(.is-multiple):not(.is-loading)\n &::after\n border-color: $input-arrow-dark\n select\n +input\n &[disabled]:hover,\n fieldset[disabled] &:hover\n border-color: $input-disabled-border-color-dark\n option\n color: $input-color-dark\n // States\n &:not(.is-multiple):not(.is-loading):hover\n &::after\n border-color: $input-hover-color-dark\n // Colors\n @each $name, $pair in $colors\n $color: darken(nth($pair, 1), 10%)\n &.is-#{$name}\n &:not(:hover)::after\n border-color: $color\n select\n border-color: $color\n &:hover,\n &.is-hovered\n border-color: darken($color, 5%)\n &:focus,\n &.is-focused,\n &:active,\n &.is-active\n box-shadow: $input-focus-box-shadow-size rgba($color, 0.25)\n // Colors Dark\n @each $name, $pair in $colors\n $color: nth($pair, 1)\n &.is-#{$name}-dark\n &:not(:hover)::after\n border-color: $color\n select\n border-color: $color\n &:hover,\n &.is-hovered\n border-color: darken($color, 5%)\n &:focus,\n &.is-focused,\n &:active,\n &.is-active\n box-shadow: $input-focus-box-shadow-size rgba($color, 0.25)\n // Modifiers\n &.is-disabled\n &::after\n border-color: $input-disabled-color-dark\n\n.file\n // Colors\n @each $name, $pair in $colors\n $color: darken(nth($pair, 1), 10%)\n $color-invert: nth($pair, 2)\n &.is-#{$name}\n .file-cta\n background-color: $color\n color: $color-invert\n &:hover,\n &.is-hovered\n .file-cta\n background-color: darken($color, 2.5%)\n color: $color-invert\n &:focus,\n &.is-focused\n .file-cta\n box-shadow: 0 0 0.5em rgba($color, 0.25)\n color: $color-invert\n &:active,\n &.is-active\n .file-cta\n background-color: darken($color, 5%)\n color: $color-invert\n // Colors Dark\n @each $name, $pair in $colors\n $color: nth($pair, 1)\n $color-invert: nth($pair, 2)\n &.is-#{$name}-dark\n .file-cta\n background-color: $color\n color: $color-invert\n &:hover,\n &.is-hovered\n .file-cta\n background-color: darken($color, 2.5%)\n color: $color-invert\n &:focus,\n &.is-focused\n .file-cta\n box-shadow: 0 0 0.5em rgba($color, 0.25)\n color: $color-invert\n &:active,\n &.is-active\n .file-cta\n background-color: darken($color, 5%)\n color: $color-invert\n\n.file-label\n &:hover\n .file-cta\n background-color: darken($file-cta-background-color-dark, 2.5%)\n color: $file-cta-hover-color-dark\n .file-name\n border-color: darken($file-name-border-color-dark, 2.5%)\n &:active\n .file-cta\n background-color: darken($file-cta-background-color-dark, 5%)\n color: $file-cta-active-color-dark\n .file-name\n border-color: darken($file-name-border-color-dark, 5%)\n\n.file-cta,\n.file-name\n border-color: $file-border-color-dark\n\n.file-cta\n background-color: $file-cta-background-color-dark\n color: $file-cta-color-dark\n\n.file-name\n border-color: $file-name-border-color-dark\n\n.label\n color: $label-color-dark\n\n.help\n @each $name, $pair in $colors\n $color: darken(nth($pair, 1), 10%)\n &.is-#{$name}\n color: $color\n @each $name, $pair in $colors\n $color: nth($pair, 1)\n &.is-#{$name}-dark\n color: $color\n\n// Containers\n\n.control\n // Modifiers\n &.has-icons-left,\n &.has-icons-right\n .icon\n color: $input-icon-color-dark\n" }, { "path": "guide/style/bulma-prefers-dark/sass/elements/notification.sass", "content": "$notification-background-color-dark: $background-dark !default\n\n.notification\n background-color: $notification-background-color-dark\n code,\n pre\n background: $black\n // Colors\n @each $name, $pair in $colors\n $color: darken(nth($pair, 1), 10%)\n $color-invert: nth($pair, 2)\n &.is-#{$name}\n background-color: $color\n color: $color-invert\n // Colors Dark\n @each $name, $pair in $colors\n $color: nth($pair, 1)\n $color-invert: nth($pair, 2)\n &.is-#{$name}-dark\n background-color: $color\n color: $color-invert\n" }, { "path": "guide/style/bulma-prefers-dark/sass/elements/other.sass", "content": ".number\n background-color: $background-dark\n" }, { "path": "guide/style/bulma-prefers-dark/sass/elements/progress.sass", "content": "$progress-bar-background-color-dark: $border-dark !default\n$progress-value-background-color-dark: $text-dark !default\n\n.progress\n &::-webkit-progress-bar\n background-color: $progress-bar-background-color-dark\n &::-webkit-progress-value\n background-color: $progress-value-background-color-dark\n &::-moz-progress-bar\n background-color: $progress-value-background-color-dark\n &::-ms-fill\n background-color: $progress-value-background-color-dark\n &:indeterminate\n background-color: $progress-bar-background-color-dark\n background-image: linear-gradient(to right, $text 30%, $progress-bar-background-color-dark 30%)\n // Colors\n @each $name, $pair in $colors\n $color: darken(nth($pair, 1), 10%)\n &.is-#{$name}\n &::-webkit-progress-value\n background-color: $color\n &::-moz-progress-bar\n background-color: $color\n &::-ms-fill\n background-color: $color\n &:indeterminate\n background-image: linear-gradient(to right, $color 30%, $progress-bar-background-color-dark 30%)\n // Colors Dark\n @each $name, $pair in $colors\n $color: nth($pair, 1)\n &.is-#{$name}-dark\n &::-webkit-progress-value\n background-color: $color\n &::-moz-progress-bar\n background-color: $color\n &::-ms-fill\n background-color: $color\n &:indeterminate\n background-image: linear-gradient(to right, $color 30%, $progress-bar-background-color-dark 30%)\n" }, { "path": "guide/style/bulma-prefers-dark/sass/elements/table.sass", "content": "$table-color-dark: $grey-lighter !default\n$table-background-color-dark: $black !default\n\n$table-cell-border-dark: 1px solid $grey-darker !default\n$table-cell-heading-color-dark: $text-strong-dark !default\n\n$table-head-cell-color-dark: $text-strong-dark !default\n$table-foot-cell-color-dark: $text-strong-dark !default\n\n$table-row-hover-background-color-dark: $black-bis !default\n\n$table-row-active-background-color-dark: $primary-dark !default\n$table-row-active-color-dark: $primary-invert-dark !default\n\n$table-striped-row-even-background-color-dark: $black-bis !default\n$table-striped-row-even-hover-background-color-dark: $black-ter !default\n\n.table\n background-color: $table-background-color-dark\n color: $table-color-dark\n td,\n th\n border: $table-cell-border-dark\n // Colors\n @each $name, $pair in $colors\n $color: darken(nth($pair, 1), 10%)\n $color-invert: nth($pair, 2)\n &.is-#{$name}\n background-color: $color\n border-color: $color\n color: $color-invert\n // Colors Dark\n @each $name, $pair in $colors\n $color: nth($pair, 1)\n $color-invert: nth($pair, 2)\n &.is-#{$name}-dark\n background-color: $color\n border-color: $color\n color: $color-invert\n // Modifiers\n &.is-selected\n background-color: $table-row-active-background-color-dark\n color: $table-row-active-color-dark\n th\n color: $table-cell-heading-color-dark\n tr\n &.is-selected\n background-color: $table-row-active-background-color-dark\n color: $table-row-active-color-dark\n td,\n th\n border-color: $table-row-active-color-dark\n thead\n td,\n th\n color: $table-head-cell-color-dark\n tfoot\n td,\n th\n color: $table-foot-cell-color-dark\n // Modifiers\n &.is-hoverable\n tbody\n tr:not(.is-selected)\n &:hover\n background-color: $table-row-hover-background-color-dark\n &.is-striped\n tbody\n tr:not(.is-selected)\n &:hover\n background-color: $table-row-hover-background-color-dark\n &:nth-child(even)\n background-color: $table-striped-row-even-hover-background-color-dark\n &.is-striped\n tbody\n tr:not(.is-selected)\n &:nth-child(even)\n background-color: $table-striped-row-even-background-color-dark\n" }, { "path": "guide/style/bulma-prefers-dark/sass/elements/tag.sass", "content": "$tag-background-color-dark: $background-dark !default\n$tag-color-dark: $text-dark !default\n\n.tag:not(body)\n background-color: $tag-background-color-dark\n color: $tag-color-dark\n // Colors\n @each $name, $pair in $colors\n $color: darken(nth($pair, 1), 10%)\n $color-invert: nth($pair, 2)\n &.is-#{$name}\n background-color: $color\n color: $color-invert\n // Colors Dark\n @each $name, $pair in $colors\n $color: nth($pair, 1)\n $color-invert: nth($pair, 2)\n &.is-#{$name}-dark\n background-color: $color\n color: $color-invert\n // Modifiers\n &.is-delete\n &:hover,\n &:focus\n background-color: darken($tag-background-color-dark, 5%)\n &:active\n background-color: darken($tag-background-color-dark, 10%)\n" }, { "path": "guide/style/bulma-prefers-dark/sass/elements/title.sass", "content": "$title-color-dark: $grey-lighter !default\n\n$subtitle-color-dark: $grey-light !default\n$subtitle-strong-color-dark: $grey-lighter !default\n\n.title\n color: $title-color-dark\n\n.subtitle\n color: $subtitle-color-dark\n strong\n color: $subtitle-strong-color-dark\n" }, { "path": "guide/style/bulma-prefers-dark/sass/layout/_all.sass", "content": "@charset \"utf-8\"\n\n@import \"hero.sass\"\n@import \"footer.sass\"\n" }, { "path": "guide/style/bulma-prefers-dark/sass/layout/footer.sass", "content": "$footer-background-color-dark: $black-bis !default\n\n.footer\n background-color: $footer-background-color-dark\n" }, { "path": "guide/style/bulma-prefers-dark/sass/layout/hero.sass", "content": "// Main container\n\n.hero\n // Colors\n @each $name, $pair in $colors\n $color: darken(nth($pair, 1), 10%)\n $color-invert: nth($pair, 2)\n &.is-#{$name}, &.is-#{$name}-dark\n background-color: $color\n color: $color-invert\n a:not(.button):not(.dropdown-item):not(.tag),\n strong\n color: inherit\n .title\n color: $color-invert\n .subtitle\n color: rgba($color-invert, 0.9)\n a:not(.button),\n strong\n color: $color-invert\n .navbar-menu\n +touch\n background-color: $color\n .navbar-item,\n .navbar-link\n color: rgba($color-invert, 0.7)\n a.navbar-item,\n .navbar-link\n &:hover,\n &.is-active\n background-color: darken($color, 5%)\n color: $color-invert\n .tabs\n a\n color: $color-invert\n opacity: 0.9\n &:hover\n opacity: 1\n li\n &.is-active a\n opacity: 1\n &.is-boxed,\n &.is-toggle\n a\n color: $color-invert\n &:hover\n background-color: rgba($black, 0.1)\n li.is-active a\n &,\n &:hover\n background-color: $color-invert\n border-color: $color-invert\n color: $color\n // Modifiers\n &.is-bold\n $gradient-top-left: darken(saturate(adjust-hue($color, -10deg), 10%), 10%)\n $gradient-bottom-right: lighten(saturate(adjust-hue($color, 10deg), 5%), 5%)\n background-image: linear-gradient(141deg, $gradient-top-left 0%, $color 71%, $gradient-bottom-right 100%)\n +mobile\n .navbar-menu\n background-image: linear-gradient(141deg, $gradient-top-left 0%, $color 71%, $gradient-bottom-right 100%)\n // Responsiveness\n // +mobile\n // .nav-toggle\n // span\n // background-color: $color-invert\n // &:hover\n // background-color: rgba($black, 0.1)\n // &.is-active\n // span\n // background-color: $color-invert\n // .nav-menu\n // .nav-item\n // border-top-color: rgba($color-invert, 0.2)\n\n // Colors dark\n @each $name, $pair in $colors\n $color: nth($pair, 1)\n $color-invert: nth($pair, 2)\n &.is-#{$name}-dark\n background-color: $color\n color: $color-invert\n a:not(.button):not(.dropdown-item):not(.tag),\n strong\n color: inherit\n .title\n color: $color-invert\n .subtitle\n color: rgba($color-invert, 0.9)\n a:not(.button),\n strong\n color: $color-invert\n .navbar-menu\n +touch\n background-color: $color\n .navbar-item,\n .navbar-link\n color: rgba($color-invert, 0.7)\n a.navbar-item,\n .navbar-link\n &:hover,\n &.is-active\n background-color: darken($color, 5%)\n color: $color-invert\n .tabs\n a\n color: $color-invert\n opacity: 0.9\n &:hover\n opacity: 1\n li\n &.is-active a\n opacity: 1\n &.is-boxed,\n &.is-toggle\n a\n color: $color-invert\n &:hover\n background-color: rgba($black, 0.1)\n li.is-active a\n &,\n &:hover\n background-color: $color-invert\n border-color: $color-invert\n color: $color\n // Modifiers\n &.is-bold\n $gradient-top-left: darken(saturate(adjust-hue($color, -10deg), 10%), 10%)\n $gradient-bottom-right: lighten(saturate(adjust-hue($color, 10deg), 5%), 5%)\n background-image: linear-gradient(141deg, $gradient-top-left 0%, $color 71%, $gradient-bottom-right 100%)\n +mobile\n .navbar-menu\n background-image: linear-gradient(141deg, $gradient-top-left 0%, $color 71%, $gradient-bottom-right 100%)\n // Responsiveness\n // +mobile\n // .nav-toggle\n // span\n // background-color: $color-invert\n // &:hover\n // background-color: rgba($black, 0.1)\n // &.is-active\n // span\n // background-color: $color-invert\n // .nav-menu\n // .nav-item\n // border-top-color: rgba($color-invert, 0.2)\n" }, { "path": "guide/style/bulma-prefers-dark/sass/utilities/_all.sass", "content": "@charset \"utf-8\"\n\n@import \"initial-variables.sass\"\n@import \"derived-variables.sass\"\n@import \"mixins.sass\"\n" }, { "path": "guide/style/bulma-prefers-dark/sass/utilities/derived-variables.sass", "content": "$primary-dark: darken($turquoise, 10%) !default\n\n$info: darken($cyan, 10%) !default\n$success: darken($green, 10%) !default\n$warning: darken($yellow, 10%) !default\n$danger: darken($red, 10%) !default\n\n$light: $white-ter !default\n$dark: $grey-darker !default\n\n// Invert colors\n\n$orange-invert: findColorInvert($orange) !default\n$yellow-invert: findColorInvert($yellow) !default\n$green-invert: findColorInvert($green) !default\n$turquoise-invert: findColorInvert($turquoise) !default\n$cyan-invert: findColorInvert($cyan) !default\n$blue-invert: findColorInvert($blue) !default\n$purple-invert: findColorInvert($purple) !default\n$red-invert: findColorInvert($red) !default\n\n$primary-invert: $turquoise-invert !default\n$primary-invert-dark: darken($turquoise-invert, 10%) !default\n$info-invert: $cyan-invert !default\n$success-invert: $green-invert !default\n$warning-invert: $yellow-invert !default\n$danger-invert: $red-invert !default\n$light-invert: $dark !default\n$dark-invert: $light !default\n\n// General colors\n\n$background: $white-ter !default\n$background-dark: $black-ter !default\n\n$border-dark: $grey-darker !default\n$border-hover-dark: $grey-dark !default\n\n// Text colors\n\n$text-dark: $grey-light !default\n$text-invert: findColorInvert($text) !default\n$text-invert-dark: findColorInvert($text-dark) !default\n$text-light: $grey !default\n$text-strong-dark: $grey-lighter !default\n\n// Code colors\n\n$code-dark: darken($red, 15%) !default\n$code-background-dark: $background-dark !default\n\n$pre-dark: $text-dark !default\n$pre-background-dark: $background-dark !default\n\n// Link colors\n\n$link-dark: $blue-light !default\n$link-invert-dark: $blue-invert !default\n\n$link-hover-dark: $grey-lighter !default\n$link-hover-border-dark: $grey-dark !default\n\n$link-focus-dark: $grey-lighter !default\n$link-focus-border-dark: $blue-light !default\n\n$link-active-dark: $grey-lighter !default\n$link-active-border-dark: $grey-light !default\n" }, { "path": "guide/style/bulma-prefers-dark/sass/utilities/initial-variables.sass", "content": "// Colors\n\n$blue-light: hsl(209, 71%, 63%) !default\n\n// Background\n\n$body-background-dark: #17181c !default\n" }, { "path": "guide/style/bulma-prefers-dark/sass/utilities/mixins.sass", "content": "// Color schemes\n\n=prefers-scheme($scheme)\n @media (prefers-color-scheme: $scheme)\n @content\n" }, { "path": "guide/style/colors.scss", "content": "$sanic: #ff0d68;\n$primary: $sanic;\n$link: $sanic;\n$blue: #0092FF;\n$cyan: $blue;\n$green: #16DB93;\n$yellow: #FFE900;\n\n$menu-item-active-background-color: $sanic;\n\n\n$green_1: #37ae6f;\n$green_2: #16DB93;\n$purple: #833FE3;\n$dark_1: #1e2024;\n$orange: #d98404;\n\n\n.has-text-purple { color: $purple; }\n" }, { "path": "guide/style/elements.scss", "content": ".footer {\n a[target=_blank]::after { display: none; }\n margin-bottom: 4rem;\n}\n@media screen and (max-width: $desktop) {\n .footer .level { align-items: baseline; }\n .footer a { font-size: 0.75em; }\n}\n.hero {\n .subtitle {\n font-size: 3rem;\n font-weight: 700;\n margin-bottom: 1rem;\n }\n .tagline {\n font-family: Fira Code,Source Code Pro,Menlo,Monaco,Consolas,Lucisa Console,monospace;\n font-size: 2rem;\n font-weight: 300;\n margin-bottom: 2rem\n }\n}\n\n.language-sh {\n code {\n display: inline-block;\n &::before {\n content: '▶ '\n }\n\n }\n}\n\n.notification {\n margin-top: 2rem;\n .notification-title {\n font-size: 1.25rem;\n font-weight: 700;\n }\n &.is-note {\n background-color: $primary;\n color: $white;\n }\n &.is-new {\n background-color: $purple;\n color: $white;\n &::after {\n content: '🌟';\n position: absolute;\n top: 1rem;\n right: 1rem;\n font-size: 2rem;\n }\n }\n &.is-tip {\n &::after {\n content: '💡';\n position: absolute;\n top: 1rem;\n right: 1rem;\n font-size: 2rem;\n }\n }\n}\n\n.ol, .ul,\n.list {\n margin: 1rem 0;\n .li,\n .list-item {\n padding: 0.5rem 0;\n }\n}\n.ul .li {\n margin-left: 1.5rem;\n list-style-type: disc;\n}\n.introduction-table {\n margin: 2rem 0;\n a[target=_blank]::after { display: none; }\n th { display: none; }\n}\n\n.docobject {\n h2 :last-child { color: $dark; }\n .function-signature {\n color: $dark_1;\n\n .param-name {\n color: $primary;\n font-weight: bold;\n }\n .param-default {\n color: $purple;\n font-style: italic;\n }\n .function-decorator {\n font-style: italic;\n color: $grey\n }\n .param-annotation { color: $blue; }\n .return-annotation { color: $green_1; }\n\n }\n\n dl {\n display: flex;\n flex-wrap: wrap;\n margin: 0;\n padding: 0;\n }\n dt {\n flex: 0 0 25%;\n padding: 5px 10px;\n font-weight: bold;\n color: $blue;\n }\n dd {\n flex: 1;\n padding: 5px 10px;\n margin: 0;\n }\n\n div.highlight + p,\n p + div.highlight,\n div.highlight + div.highlight { margin-top: 1rem; }\n\n .method {\n padding-left: 1rem;\n\n h3 { margin-left: -1rem; }\n }\n\n .ol, .ul, .list { margin: 1rem; }\n}\n\n.mermaid {\n margin-top: 2rem;\n .actor {\n stroke: $primary !important;\n fill: lighten($primary, 40%) !important;\n }\n .labelBox {\n fill: lighten($blue, 40%) !important;\n stroke: $blue !important;\n }\n // .labelText {\n // fill: $white-bis !important;\n // }\n .note {\n fill: lighten($yellow, 40%) !important;\n stroke: $yellow !important;\n }\n}\n\n@media (prefers-color-scheme: dark) {\n .docobject {\n h2 :last-child { color: $white-bis; }\n .function-signature {\n color: $grey-light;\n .param-default { color: $yellow; }\n }\n }\n .mermaid {\n text.messageText { fill: $white-bis !important; }\n .actor { fill: $primary !important; }\n .labelBox { fill: $blue !important; }\n .labelText { fill: $white-bis !important; }\n .note { fill: $yellow !important; }\n }\n}\n\n$button-width: 36px;\n$button-height: 52px; // 36 x 52 for portrait paper ratio\n$rectangle-width: $button-width / 2;\n$rectangle-height: $rectangle-width / 8.5 * 11;\n$left-offset-filled: 5px;\n$top-offset-filled: 13px;\n$left-offset-outlined: -3px;\n$top-offset-outlined: 5px;\n$animation-slide: -$button-width / 1.5; // space for sliding and the gap\n\nh1 + .code-block,\nh2 + .code-block,\nh3 + .code-block { margin-top: 1rem; }\n.code-block {\n position: relative;\n & + .code-block { margin-top: 1rem; }\n\n &:hover {\n .code-block__copy {\n opacity: 1;\n }\n }\n\n .code-block__copy {\n position: absolute;\n right: 10px;\n bottom: 10px;\n width: $button-width;\n height: $button-height;\n cursor: pointer;\n opacity: 0;\n transition: all 0.3s;\n\n &::before {\n content: \"copied\";\n position: absolute;\n top: -$button-height / 3;\n margin: auto;\n opacity: 0;\n right: $button-width / 4;\n }\n &.clicked::before {\n opacity: 1;\n animation: all 0.3s ease-in-out;\n }\n }\n\n .code-block__rectangle {\n position: absolute;\n width: $rectangle-width;\n height: $rectangle-height;\n transition: all 0.3s ease;\n }\n\n .code-block__filled {\n background-color: $primary;\n left: $left-offset-filled;\n top: $top-offset-filled;\n }\n\n .code-block__outlined {\n border: 2px solid $primary;\n background-color: transparent;\n left: $left-offset-outlined;\n top: $top-offset-outlined;\n }\n\n .code-block__copy.clicked {\n .code-block__outlined {\n left: $left-offset-filled + $animation-slide;\n top: $top-offset-filled;\n background-color: $primary;\n }\n }\n}\n\n.additional-attributes.details {\n display: flex;\n flex-direction: column;\n width: 100%;\n\n .code-block {\n display: none;\n width: 100%;\n }\n\n &::before {\n content: \"▼ \" attr(title);\n display: block;\n background-color: $grey-light;\n padding: 10px;\n cursor: pointer;\n width: 100%;\n box-sizing: border-box;\n }\n\n &.is-active {\n .code-block {\n display: block;\n }\n\n &::before {\n content: \"▲ \" attr(title);\n background-color: $grey-lighter;\n }\n }\n}\n\n// dark mode\n@media (prefers-color-scheme: dark) {\n .additional-attributes.details{\n &::before { background-color: $grey-darker; }\n &.is-active {\n &::before { background-color: $grey-dark; }\n }\n }\n}\n\n.tabs {\n .tab-content { display: none; }\n}\n\n.table-of-contents {\n position: fixed;\n right: 0;\n bottom: 0;\n z-index: 1000;\n max-width: 500px;\n padding: 1rem 2rem;\n background-color: $white-bis;\n box-shadow: 0 0 2px rgba(63, 63, 68, 0.5);\n\n @media (prefers-color-scheme: dark) {\n background-color: $black;\n box-shadow: 0 0 2px rgba(191, 191, 191, 0.5);\n \n }\n\n .table-of-contents-item {\n display: block;\n margin-bottom: 0.5rem;\n text-decoration: none;\n\n &:hover {\n\ttext-decoration: underline;\n\tcolor: $primary;\n\n\tstrong, small {\n\t color: $primary;\n\t}\n }\n\n strong {\n\tcolor: $black-bis;\n\tfont-size: 1.15em;\n\tdisplay: block;\n\tline-height: 1rem;\n\tmargin-top: 0.75rem;\n }\n\n small {\n\tcolor: $grey;\n\tfont-size: 0.85em;\n }\n\n @media (prefers-color-scheme: dark) {\n\tstrong { color: $grey-lighter; }\n }\n }\n\n @media (max-width: 768px) {\n position: static;\n max-width: calc(100vw - 2rem);\n\n .table-of-contents-item {\n\tdisplay: flex;\n\tflex-direction: row-reverse;\n\tjustify-content: start;\n\t\n\tstrong {\n\t display: inline;\n\t margin: 0 0 0 0.75rem;\n\t}\n }\n }\n}\n\n.loading-bar {\n position: fixed;\n top: 0;\n left: 0;\n width: 100%;\n height: 3px;\n background-color: transparent;\n z-index: 9999;\n\n &.is-loading {\n background-color: $primary;\n animation: pulsingLoading 1s linear infinite;\n }\n}\n\n@keyframes pulsingLoading {\n 0%, 100% {\n transform: scaleX(1);\n opacity: 1;\n }\n 50% {\n transform: scaleX(0.25);\n opacity: 0.5;\n }\n}\n.changelog {\n .ol, .ul, .list {\n\t.li, .list-item { padding: 0; }\n }\n}\n\n.sponsors {\n display: flex;\n flex-wrap: wrap;\n justify-content: center;\n text-align: center;\n padding: 0.25rem 0;\n .button { margin-left: 1rem; }\n}\n" }, { "path": "guide/style/general.scss", "content": "code { color: #{$grey-dark}; }\n.notification code { background-color: #{rgba($grey-lightest, 0.6)}; }\n@media (prefers-color-scheme: dark) {\n code { color: #{$grey-lighter}; }\n .notification code {\n background-color: #{rgba($black-ter, 0.6)};\n }\n}\n\na{\n &[target=_blank]::after {\n content: \"⇗\";\n margin-left: 0.25em;\n }\n & > code {\n border-bottom: 1px solid $primary;\n &:hover {\n background-color: $primary;\n color: $white;\n }\n }\n}\nh1 a.anchor,\nh2 a.anchor,\nh3 a.anchor,\nh4 a.anchor,\nh5 a.anchor,\nh6 a.anchor {\n display: none;\n padding-left: 0.375em;\n}\nh1:hover a.anchor,\nh2:hover a.anchor,\nh3:hover a.anchor,\nh4:hover a.anchor,\nh5:hover a.anchor,\nh6:hover a.anchor {\n display: inline;\n}\n\nh1 { margin-left: -2rem; }\nh2 { margin-left: -1rem; margin-top: 3rem; }\nh3:not(:first-child) { margin-top: 2rem; }\narticle { margin-left: 2rem; }\np + pre,\npre + p,\ndiv.highlight + p,\np + div.highlight,\ndiv.highlight + div.highlight,\np + h4,\np + .code-block,\n.code-block + p,\n.code-block + .code-block,\np + p { margin-top: 1rem; }\n\n@media screen and (max-width: $tablet) {\n html { font-size: 18px; }\n h1 { margin-left: 0; }\n h2 { margin-left: 0; }\n article { margin-left: 0; }\n .section {\n\tpadding: 1rem 0rem;\n\tmax-width: 95vw;\n }\n}\n@media screen and (min-width: $widescreen) {\n .section {\n\tpadding: 3rem 0rem;\n }\n}\n@media screen and (min-width: $widescreen) {\n .section {\n\tpadding: 3rem 0rem;\n }\n}\n" }, { "path": "guide/style/home.scss", "content": "@media screen and (min-width: 769px) {\n .hero.is-large .hero-body {\n\tpadding: 18rem 6rem 3rem;\n }\n}\n@media screen and (max-width: 769px) {\n .hero {\n height: 100vh;\n\tmargin-top: 15vh;\n\n .hero-body {\n padding: 3rem 1.5rem;\n display: flex;\n flex-direction: column;\n justify-content: center;\n }\n & .title::after {\n width: calc(100vw - 1.5rem);\n background: url(/assets/images/logo-white.svg) no-repeat center center;\n background-size: 100% auto;\n }\n\t.subtitle {\n\t margin-top: 1rem;\n\t font-size: 1.4rem;\n\t}\n\t.tagline {\n\t font-size: 1.1rem;\n\t}\n }\n}\n.home .tab-container {\n display: flex;\n\n .tabs {\n flex-shrink: 0; // Prevent the tabs from shrinking\n width: 200px; // Fixed width for the tabs\n ul {\n display: flex;\n flex-direction: column;\n border-bottom: none; // Remove the border between tabs\n }\n li {\n\tdisplay: block;\n\twidth: 100%;\n a {\n display: block;\n padding: 0.5em 1em; // Adjust padding as needed\n text-align: left; // Align text to the left\n }\n }\n }\n\n .tab-display {\n flex-grow: 1; // Allow the content to grow as needed\n min-width: 0; // Allows the flex item to shrink below its content size\n padding-left: 20px; // Adjust the spacing between tabs and content as needed\n }\n\n @media screen and (max-width: 768px) {\n flex-direction: column;\n\n .tabs {\n width: 100%; // Tabs take full width for mobile\n ul {\n display: block; // Vertical tabs\n overflow-y: auto; // For scrollable tabs vertically\n }\n li {\n display: block; // Keep tabs vertical\n }\n }\n\n .tab-display {\n padding-left: 0; // Reset padding for mobile view\n }\n }\n}\n" }, { "path": "guide/style/index.scss", "content": "$body-size: 20px;\n\n@import \"./colors.scss\";\n@import \"./bulma/bulma.sass\";\n@import \"./bulma-prefers-dark/bulma-prefers-dark.sass\";\n@import \"./theme.scss\";\n@import \"./menu.scss\";\n@import \"./general.scss\";\n@import \"./elements.scss\";\n@import \"./home.scss\";\n@import \"./overrides.scss\";\n" }, { "path": "guide/style/menu.scss", "content": "$arrow-size: 8px;\n$burger-size: 2rem;\n$menu-width: 360px;\n.burger {\n display: none;\n position: fixed;\n top: 1rem;\n right: $burger-size / 2;\n width: $burger-size;\n height: $burger-size;\n cursor: pointer;\n z-index: 101;\n span {\n display: block;\n position: absolute;\n height: 2px;\n width: 100%;\n background: var(--menu-contrast);\n border-radius: 2px;\n opacity: 1;\n left: 0;\n transform: rotate(0deg);\n transition: .25s ease-in-out;\n &:nth-child(1) { top: 0px; }\n &:nth-child(2), &:nth-child(3) { top: 8px; }\n &:nth-child(4) { top: 16px; }\n }\n &.is-active {\n span {\n &:nth-child(1) {\n top: 18px;\n width: 0%;\n left: 50%;\n }\n &:nth-child(2) {\n transform: rotate(45deg);\n }\n &:nth-child(3) {\n transform: rotate(-45deg);\n }\n &:nth-child(4) {\n top: 18px;\n width: 0%;\n left: 50%;\n }\n }\n }\n &::after {\n\tcontent: '';\n\tdisplay: block;\n\tposition: absolute;\n\ttop: -$burger-size / 2;\n\tleft: -$burger-size / 4;\n\twidth: $burger-size * 1.5;\n\theight: $burger-size * 1.5;\n\tbackground: var(--menu-background);\n\tz-index: -1;\n }\n}\n.menu {\n background-color: var(--menu-background);\n width: $menu-width;\n padding: 2rem;\n height: 100vh;\n overflow: auto;\n position: fixed;\n top: 0;\n left: 0;\n z-index: 100;\n\n hr { background-color: var(--menu-divider); }\n\n .is-anchor {\n font-size: 0.75em;\n & a::before {\n content: '# ';\n color: var(--menu-contrast);\n }\n }\n .menu-label { margin-bottom: 1rem; }\n li.is-group > a {\n\tfont-size: 0.85rem;\n &::after {\n content: '';\n position: relative;\n top: -$arrow-size / 4;\n left: $arrow-size;\n display: inline-block;\n width: 0;\n height: 0;\n border-left: $arrow-size solid var(--menu-contrast);\n border-top: $arrow-size * 2/3 solid transparent;\n border-bottom: $arrow-size * 2/3 solid transparent;\n transform: rotate(90deg);\n }\n & ~ .menu-list {\n transition: all .15s ease-in-out;\n transform: scaleY(1);\n transform-origin: top;\n overflow: hidden;\n opacity: 1;\n margin: 0;\n }\n &:not(.is-open) {\n &::after { transform: rotate(0deg); }\n & ~ .menu-list {\n transform: scaleY(0);\n opacity: 0;\n font-size: 0;\n }\n }\n }\n\n & ~ main { margin-left: $menu-width; }\n .anchor-list {\n display: none;\n }\n .menu-item .is-active + .anchor-list {\n display: block;\n }\n}\n\n// On mobile breakpoints, we want to hide the menu and show the burger\n@media screen and (max-width: $desktop) {\n .menu {\n left: -100vw;\n width: 100vw;\n transition: all .25s ease-in-out;\n &.is-active { left: 0; }\n & ~ main { margin-left: 0; }\n }\n .burger { display: block; }\n}\n\n.menu-list li ul {\n margin: 0;\n padding-left: 0;\n}\n.menu-list ul li:not(.is-anchor) {\n margin-left: 0.75em;\n}\n.menu-list .menu-list li a {\n font-size: 0.85em;\n}\n" }, { "path": "guide/style/overrides.scss", "content": "footer .level,\nfooter .level .level-right,\nfooter .level .level-left {\n display: flex !important;\n}\n.tabs li a { font-size: 0.7rem; }\n.box {\n box-shadow: 0 2px 3px rgba(10, 10, 10, 0.1), 0 0 0 1px rgba(10, 10, 10, 0.1);\n}\n.container { padding: 0 0.5rem; }\n@media (prefers-color-scheme: dark) {\n .box {\n box-shadow: 0 2px 3px rgba(128, 128, 128, 0.1), 0 0 0 1px rgba(128, 128, 128, 0.1);\n }\n}\n" }, { "path": "guide/style/theme.scss", "content": "$background-image-size: 270px;\n.hero .title {\n position: relative;\n span { display: none; }\n &::after {\n content: \"\";\n position: absolute;\n top: -108px;\n left: 0;\n right: 0;\n margin: auto;\n width: 500px;\n height: 122px;\n background: url(/assets/images/logo.svg) no-repeat center center;\n }\n\n}\n\n.sanic-simple-logo {\n background: url(/assets/images/logo.svg) no-repeat;\n background-size: $background-image-size;\n height: 72px;\n\n & img { visibility: hidden; }\n}\n:root {\n --menu-background: #{$grey-lightest};\n --menu-divider: #{$grey-lighter};\n --menu-contrast: #{$black-bis};\n}\n\n.c1 { color: #{$grey}; }\n\n@media (prefers-color-scheme: dark) {\n :root {\n --menu-background: #{$black};\n --menu-divider: #{$black-ter};\n --menu-contrast: #{$grey};\n }\n html,\n .navbar { background-color: #{$black-bis}; }\n .footer { background-color: #{$black}; }\n .sanic-simple-logo {\n background: url(/assets/images/logo-white.svg) no-repeat;\n background-size: $background-image-size;\n }\n .hero .title::after {\n background: url(/assets/images/logo-white.svg) no-repeat center center;\n }\n .list {\n background-color: transparent;\n box-shadow: none;\n }\n .n,.na,.nb,.no,.nd,.ni,.ne,.nl,\n .nn,.nx,.py,.nt,.nv,.bp,.vc,.vg,\n .vi,.vm { color: #{$grey-light}; }\n .s,.sa,.sb,.sc,.dl,.sd,.s2,.se,\n .sh,.si,.sx,.sr,.s1,.ss{\n background-color: transparent;\n color: #{$green};\n }\n .nc { color: #{$yellow}; }\n .c1 { color: #{$grey-dark}; }\n .introduction-table .table tbody tr:last-child td { border-bottom-width: 1px; }\n\n $scrollbar-width: 12px;\n ::-webkit-scrollbar { width: $scrollbar-width; height: $scrollbar-width; }\n ::-webkit-scrollbar-track { background: #{$black-ter}; }\n ::-webkit-scrollbar-thumb {\n\tbackground: #{$black-bis};\n\tborder-radius: 6px;\n\tborder: 3px solid #{$black-ter};\n }\n ::-webkit-scrollbar-thumb:hover { background: #{$black}; }\n}\n" }, { "path": "guide/webapp/__init__.py", "content": "" }, { "path": "guide/webapp/display/__init__.py", "content": "" }, { "path": "guide/webapp/display/base.py", "content": "from __future__ import annotations\n\nfrom os import environ\n\nfrom html5tagger import Builder, Document, E # type: ignore\n\n\nclass BaseRenderer:\n def __init__(self, base_title: str):\n self.base_title = base_title\n\n def get_builder(self, full: bool, language: str) -> Builder:\n if full:\n urls = [\n \"/assets/code.css\",\n \"/assets/style.css\",\n \"/assets/docs.js\",\n \"https://unpkg.com/htmx.org@1.9.2/dist/htmx.min.js\",\n \"https://cdn.jsdelivr.net/npm/mermaid@10/dist/mermaid.min.js\",\n ]\n builder = Document(\n self.title(), lang=language, _urls=urls, _viewport=True\n )\n builder(*self._head())\n builder.full = True\n else:\n builder = Builder(name=\"Partial\")\n builder.full = False\n return builder\n\n def title(self) -> str:\n return self.base_title\n\n def _head(self) -> list[Builder]:\n head = [\n E.meta(name=\"theme-color\", content=\"#ff0d68\"),\n E.meta(name=\"title\", content=self.title()),\n E.meta(\n name=\"description\",\n content=(\n \"Sanic is a Python 3.10+ web server and \"\n \"web framework that's written to go fast.\"\n ),\n ),\n E.link(rel=\"icon\", href=\"/favicon.ico\", sizes=\"any\"),\n E.link(rel=\"icon\", href=\"/favicon-32x32.png\", type=\"image/png\"),\n E.link(rel=\"icon\", href=\"/favicon-16x16.png\", type=\"image/png\"),\n E.link(\n rel=\"apple-touch-icon\",\n sizes=\"180x180\",\n href=\"/apple-touch-icon.png\",\n ),\n E.link(rel=\"manifest\", href=\"/site.webmanifest\"),\n E.link(\n rel=\"android-chrome\",\n sizes=\"192x192\",\n href=\"/android-chrome-192x192.png\",\n ),\n E.link(\n rel=\"android-chrome\",\n sizes=\"512x512\",\n href=\"/android-chrome-512x512.png\",\n ),\n E.meta(name=\"msapplication-config\", content=\"/browserconfig.xml\"),\n E.meta(name=\"msapplication-TileColor\", content=\"#ffffff\"),\n E.meta(\n name=\"msapplication-TileImage\", content=\"/mstile-144x144.png\"\n ),\n E.meta(name=\"theme-color\", content=\"#ff0d68\"),\n E.link(\n rel=\"mask-icon\", href=\"/safari-pinned-tab.svg\", color=\"#ff0d68\"\n ),\n ]\n umami = E.script(\n None,\n async_=True,\n defer=True,\n data_website_id=\"0131e426-4d6d-476b-a84b-34a45e0be6de\",\n src=\"https://analytics.sanicframework.org/umami.js\",\n )\n if environ.get(\"UMAMI\"):\n head.append(umami)\n return head\n" }, { "path": "guide/webapp/display/code_style.py", "content": "from pygments.style import Style\nfrom pygments.token import ( # Error,; Generic,; Number,; Operator,\n Comment,\n Keyword,\n Name,\n String,\n Token,\n)\n\n\nclass SanicCodeStyle(Style):\n styles = {\n Token: \"#777\",\n Comment: \"italic #a2a2a2\",\n Keyword: \"#ff0d68\",\n Name: \"#333\",\n Name.Class: \"bold #37ae6f\",\n Name.Function: \"#0092FF\",\n String: \"bg:#eee #833FE3\",\n }\n" }, { "path": "guide/webapp/display/layouts/__init__.py", "content": "" }, { "path": "guide/webapp/display/layouts/base.py", "content": "from __future__ import annotations\n\nfrom collections.abc import Generator\nfrom contextlib import contextmanager\n\nfrom html5tagger import Builder\n\nfrom sanic import Request\n\n\nclass BaseLayout:\n def __init__(self, builder: Builder):\n self.builder = builder\n\n @contextmanager\n def __call__(\n self, request: Request, full: bool = True\n ) -> Generator[BaseLayout, None, None]:\n with self.layout(request, full=full):\n yield self\n\n @contextmanager\n def layout(\n self, request: Request, full: bool = True\n ) -> Generator[None, None, None]:\n yield\n" }, { "path": "guide/webapp/display/layouts/elements/__init__.py", "content": "" }, { "path": "guide/webapp/display/layouts/elements/footer.py", "content": "from collections import deque\nfrom datetime import datetime\n\nfrom html5tagger import Builder, E # type: ignore\n\nfrom sanic import Request\n\n\ndef do_footer(\n builder: Builder,\n request: Request,\n extra_classes: str = \"\",\n with_pagination: bool = True,\n) -> None:\n content = deque([_content()])\n if with_pagination:\n content.appendleft(_pagination(request))\n css_classes = \"footer\"\n if extra_classes:\n css_classes += f\" {extra_classes}\"\n builder.footer(\n *content,\n class_=css_classes,\n )\n\n\ndef _pagination(request: Request) -> Builder:\n return E.div(\n _pagination_left(request), _pagination_right(request), class_=\"level\"\n )\n\n\ndef _pagination_left(request: Request) -> Builder:\n item = E.div(class_=\"level-item\")\n if not hasattr(request.ctx, \"previous_page\"):\n return E.div(item, class_=\"level-left\")\n with item:\n if p := request.ctx.previous_page:\n path = p.relative_path.with_suffix(\".html\")\n item.a(\n f\"← {p.meta.title}\",\n href=f\"/{path}\",\n hx_get=f\"/{path}\",\n hx_target=\"#content\",\n hx_swap=\"innerHTML\",\n hx_push_url=\"true\",\n class_=\"button pagination\",\n )\n return E.div(item, class_=\"level-left\")\n\n\ndef _pagination_right(request: Request) -> Builder:\n item = E.div(class_=\"level-item\")\n if not hasattr(request.ctx, \"next_page\"):\n return E.div(item, class_=\"level-right\")\n with item:\n if p := request.ctx.next_page:\n path = p.relative_path.with_suffix(\".html\")\n item.a(\n f\"{p.meta.title} →\",\n href=f\"/{path}\",\n hx_get=f\"/{path}\",\n hx_target=\"#content\",\n hx_swap=\"innerHTML\",\n hx_push_url=\"true\",\n class_=\"button pagination\",\n )\n return E.div(item, class_=\"level-right\")\n\n\ndef _content() -> Builder:\n year = datetime.now().year\n legal = E.p(\n E.a(\n \"MIT Licensed\",\n href=\"https://github.com/sanic-org/sanic/blob/master/LICENSE\",\n target=\"_blank\",\n rel=\"nofollow noopener noreferrer\",\n ).br()(\n E.small(f\"Copyright © 2018-{year} Sanic Community Organization\")\n ),\n )\n powered = E.p(\n E.a(\"This site is powered\", href=\"/en/built-with-sanic.html\"),\n E.img(\n src=\"/assets/images/sanic-framework-logo-circle-32x32.png\",\n alt=\"Sanic Logo\",\n style=\"vertical-align: middle;\",\n class_=\"ml-1\",\n ),\n )\n with_love = E.p(\"~ Made with ❤️ and ☕️ ~\")\n return E.div(\n legal,\n powered,\n with_love,\n class_=\"content has-text-centered\",\n )\n" }, { "path": "guide/webapp/display/layouts/elements/navbar.py", "content": "from html5tagger import Builder, E # type: ignore\n\nfrom sanic import Request\nfrom webapp.display.layouts.models import MenuItem\n\n\ndef do_navbar(builder: Builder, request: Request) -> None:\n navbar_items = [\n _render_navbar_item(item, request)\n for item in request.app.config.NAVBAR\n ]\n container = E.div(\n _search_form(request), *navbar_items, class_=\"navbar-end\"\n )\n\n builder.nav(\n E.div(container, class_=\"navbar-menu\"),\n class_=\"navbar is-hidden-touch\",\n )\n\n\ndef _search_form(request: Request) -> Builder:\n return E.div(\n E.div(\n E.input(\n id_=\"search\",\n type_=\"text\",\n placeholder=\"Search\",\n class_=\"input\",\n value=request.args.get(\"q\", \"\"),\n hx_target=\"#content\",\n hx_swap=\"innerHTML\",\n hx_push_url=\"true\",\n hx_trigger=\"keyup changed delay:500ms\",\n hx_get=f\"/{request.ctx.language}/search\",\n hx_params=\"*\",\n ),\n class_=\"control\",\n ),\n class_=\"navbar-item\",\n )\n\n\ndef _render_navbar_item(item: MenuItem, request: Request) -> Builder:\n if item.items:\n return E.div(\n E.a(item.label, class_=\"navbar-link\"),\n E.div(\n *(\n _render_navbar_item(subitem, request)\n for subitem in item.items\n ),\n class_=\"navbar-dropdown\",\n ),\n class_=\"navbar-item has-dropdown is-hoverable\",\n )\n\n kwargs = {\n \"class_\": \"navbar-item\",\n }\n if item.href:\n kwargs[\"href\"] = item.href\n kwargs[\"target\"] = \"_blank\"\n kwargs[\"rel\"] = \"nofollow noopener noreferrer\"\n elif item.path:\n kwargs[\"href\"] = f\"/{request.ctx.language}/{item.path}\"\n internal = [item.label]\n return E.a(*internal, **kwargs)\n" }, { "path": "guide/webapp/display/layouts/elements/sidebar.py", "content": "from html5tagger import Builder, E # type: ignore\n\nfrom sanic import Request\nfrom webapp.display.layouts.models import MenuItem\nfrom webapp.display.text import slugify\n\n\ndef do_sidebar(builder: Builder, request: Request) -> None:\n builder.a(class_=\"burger\")(E.span().span().span().span())\n builder.aside(*_menu_items(request), class_=\"menu\")\n\n\ndef _menu_items(request: Request) -> list[Builder]:\n return [\n _sanic_logo(request),\n *_sidebar_items(request),\n E.hr(),\n E.p(\"Current with version \").strong(\n request.app.config.GENERAL.current_version\n ),\n E.hr(),\n E.ul.li(\"Need \").a(\"help\", href=f\"/{request.ctx.language}/help.html\")(\n \"?\"\n ),\n E.li(\"How we \").a(\n \"built this site w/ Sanic\",\n href=f\"/{request.ctx.language}/built-with-sanic.html\",\n ),\n E.li(\"The \").a(\n \"Awesome Sanic\",\n href=\"https://github.com/mekicha/awesome-sanic\",\n target=\"_blank\",\n )(\" list\"),\n E.hr(),\n E.p(\"Want more? \")\n .a(\"sanicbook.com\", href=\"https://sanicbook.com\", target=\"_blank\")\n .br.img(src=\"https://sanicbook.com/images/SanicCoverFinal.png\"),\n E.br.small(\"Book proceeds fund our journey\"),\n E.hr(),\n E.p(\"Secure, auto-document, and monetize your Sanic API with:\").a(\n E.img(\n src=\"/assets/images/zuplo.svg\",\n alt=(\n \"Zuplo - Secure, auto-document, \"\n \"and monetize your Sanic API\"\n ),\n style=\"width: 90%;\",\n ),\n href=\"https://zuplo.com\",\n target=\"_blank\",\n rel=\"nofollow noopener noreferrer\",\n ),\n ]\n\n\ndef _sanic_logo(request: Request) -> Builder:\n return E.a(\n class_=\"navbar-item sanic-simple-logo my-3\",\n href=f\"https://sanic.dev/{request.ctx.language}/\",\n )(\n E.img(\n src=\"/assets/images/sanic-framework-logo-simple-400x97.png\", # noqa: E501\n alt=\"Sanic Framework\",\n )\n )\n\n\ndef _sidebar_items(request: Request) -> list[Builder]:\n return [\n builder\n for item in request.app.config.SIDEBAR\n for builder in _render_sidebar_item(item, request, True)\n ]\n\n\ndef _render_sidebar_item(\n item: MenuItem, request: Request, root: bool = False\n) -> list[Builder]:\n builders: list[Builder] = []\n if root:\n builders.append(E.p(class_=\"menu-label\")(item.label))\n else:\n builders.append(_single_sidebar_item(item, request))\n\n if item.items:\n ul = E.ul(class_=\"menu-list\")\n with ul:\n for subitem in item.items:\n sub_builders = _render_sidebar_item(subitem, request)\n ul(*sub_builders)\n builders.append(ul)\n\n return builders\n\n\ndef _single_sidebar_item(item: MenuItem, request: Request) -> Builder:\n if item.path and item.path.startswith(\"/\"):\n path = item.path\n else:\n path = f\"/{request.ctx.language}/{item.path}\" if item.path else \"\"\n kwargs = {}\n classes: list[str] = []\n li_classes = \"menu-item\"\n _, page, _ = request.app.ctx.get_page(\n request.ctx.language, item.path or \"\"\n )\n if request.path == path:\n classes.append(\"is-active\")\n if item.href:\n kwargs[\"href\"] = item.href\n kwargs[\"target\"] = \"_blank\"\n kwargs[\"rel\"] = \"nofollow noopener noreferrer\"\n elif not path:\n li_classes += \" is-group\"\n if _is_open_item(item, request.ctx.language, request.path):\n classes.append(\"is-open\")\n else:\n kwargs.update(\n {\n \"href\": path,\n \"hx-get\": path,\n \"hx-target\": \"#content\",\n \"hx-swap\": \"innerHTML\",\n \"hx-push-url\": \"true\",\n }\n )\n kwargs[\"class_\"] = \" \".join(classes)\n inner = E().a(item.label, **kwargs)\n if page and page.anchors:\n with inner.ul(class_=\"anchor-list\"):\n for anchor in page.anchors:\n inner.li(\n E.a(anchor.strip(\"`\"), href=f\"{path}#{slugify(anchor)}\"),\n class_=\"is-anchor\",\n )\n return E.li(inner, class_=li_classes)\n\n\ndef _is_open_item(item: MenuItem, language: str, current_path: str) -> bool:\n path = f\"/{language}/{item.path}\" if item.path else \"\"\n if current_path == path:\n return True\n for subitem in item.items:\n if _is_open_item(subitem, language, current_path):\n return True\n return False\n" }, { "path": "guide/webapp/display/layouts/home.py", "content": "from __future__ import annotations\n\nfrom collections.abc import Generator\nfrom contextlib import contextmanager\n\nfrom html5tagger import Builder, E\n\nfrom sanic import Request\nfrom webapp.display.layouts.elements.footer import do_footer\n\nfrom .base import BaseLayout\n\n\nclass HomeLayout(BaseLayout):\n @contextmanager\n def layout(\n self, request: Request, full: bool = True\n ) -> Generator[None, None, None]:\n self._sponsors()\n self._hero(request.ctx.language)\n with self.builder.div(class_=\"home container\"):\n yield\n self._footer(request)\n\n def _hero(self, language: str) -> None:\n with self.builder.section(class_=\"hero is-large has-text-centered\"):\n self.builder.div(\n E.h1(E.span(\"Sanic\"), class_=\"title\"),\n E.h2(class_=\"subtitle\")(\"Build fast. Run fast.\"),\n E.h3(class_=\"tagline\")(\"Accelerate your web app development\"),\n self._do_buttons(language),\n class_=\"hero-body\",\n )\n\n def _do_buttons(self, language: str) -> Builder:\n builder = E.div(class_=\"buttons is-centered\")\n with builder:\n builder.a(\n \"Get Started\",\n class_=\"button is-primary\",\n href=f\"/{language}/guide/getting-started.html\",\n )\n builder.a(\n \"Help\",\n class_=\"button is-outlined\",\n href=f\"/{language}/help.html\",\n )\n builder.a(\n \"GitHub\",\n class_=\"button is-outlined\",\n href=\"https://github.com/sanic-org/sanic\",\n target=\"_blank\",\n )\n return builder\n\n def _sponsors(self) -> None:\n with self.builder.section(class_=\"sponsors\"):\n self.builder(\n \"Secure, auto-document, and monetize \"\n \"your Sanic API with Zuplo\",\n E.a(\n \"Start free\",\n href=\"https://zuplo.com\",\n target=\"_blank\",\n class_=\"button is-primary is-small\",\n ),\n )\n\n def _footer(self, request: Request) -> None:\n do_footer(\n self.builder,\n request,\n extra_classes=\"mb-0 mt-6\",\n with_pagination=False,\n )\n" }, { "path": "guide/webapp/display/layouts/main.py", "content": "from collections.abc import Generator\nfrom contextlib import contextmanager\n\nfrom sanic import Request\nfrom webapp.display.layouts.elements.footer import do_footer\nfrom webapp.display.layouts.elements.navbar import do_navbar\nfrom webapp.display.layouts.elements.sidebar import do_sidebar\n\nfrom .base import BaseLayout\n\n\nclass MainLayout(BaseLayout):\n @contextmanager\n def layout(\n self, request: Request, full: bool = True\n ) -> Generator[None, None, None]:\n if full:\n self.builder.div(class_=\"loading-bar\")\n with self.builder.div(class_=\"is-flex\"):\n self._sidebar(request)\n with self.builder.main(class_=\"is-flex-grow-1\"):\n self._navbar(request)\n with self.builder.div(class_=\"container\", id=\"content\"):\n with self._content_wrapper(request):\n yield\n self._footer(request)\n else:\n with self._content_wrapper(request):\n yield\n self._footer(request)\n\n @contextmanager\n def _content_wrapper(\n self, request: Request\n ) -> Generator[None, None, None]:\n current_page = (\n request.ctx.current_page\n if hasattr(request.ctx, \"current_page\")\n else None\n )\n section_class = \"section\"\n if current_page and current_page.meta.content_class:\n section_class += f\" {current_page.meta.content_class}\"\n with self.builder.section(class_=section_class):\n with self.builder.article():\n yield\n\n def _navbar(self, request: Request) -> None:\n do_navbar(self.builder, request)\n\n def _sidebar(self, request: Request) -> None:\n do_sidebar(self.builder, request)\n\n def _footer(self, request: Request) -> None:\n do_footer(self.builder, request)\n" }, { "path": "guide/webapp/display/layouts/models.py", "content": "from __future__ import annotations\n\nfrom msgspec import Struct, field\n\n\nclass MenuItem(Struct, kw_only=False, omit_defaults=True):\n label: str\n path: str | None = None\n href: str | None = None\n items: list[MenuItem] = field(default_factory=list)\n\n\nclass GeneralConfig(Struct, kw_only=False):\n current_version: str\n" }, { "path": "guide/webapp/display/markdown.py", "content": "import re\n\nfrom textwrap import dedent\n\nfrom html5tagger import HTML, Builder, E # type: ignore\nfrom mistune import HTMLRenderer, create_markdown, escape\nfrom mistune.directives import RSTDirective, TableOfContents\nfrom mistune.util import safe_entity\nfrom pygments import highlight\nfrom pygments.formatters import html\nfrom pygments.lexers import get_lexer_by_name\n\nfrom .code_style import SanicCodeStyle\nfrom .plugins.attrs import Attributes\nfrom .plugins.columns import Column\nfrom .plugins.hook import Hook\nfrom .plugins.inline_directive import inline_directive\nfrom .plugins.mermaid import Mermaid\nfrom .plugins.notification import Notification\nfrom .plugins.span import span\nfrom .plugins.tabs import Tabs\nfrom .text import slugify\n\n\nclass DocsRenderer(HTMLRenderer):\n def block_code(self, code: str, info: str | None = None):\n builder = Builder(\"Block\")\n with builder.div(class_=\"code-block\"):\n if info:\n lexer = get_lexer_by_name(info, stripall=False)\n formatter = html.HtmlFormatter(\n style=SanicCodeStyle,\n wrapcode=True,\n cssclass=f\"highlight language-{info}\",\n )\n builder(HTML(highlight(code, lexer, formatter)))\n with builder.div(\n class_=\"code-block__copy\",\n onclick=\"copyCode(this)\",\n ):\n builder.div(\n class_=\"code-block__rectangle code-block__filled\"\n ).div(class_=\"code-block__rectangle code-block__outlined\")\n else:\n builder.pre(E.code(escape(code)))\n return str(builder)\n\n def heading(self, text: str, level: int, **attrs) -> str:\n ident = slugify(text)\n if level > 1:\n text += self._make_tag(\n \"a\", {\"href\": f\"#{ident}\", \"class\": \"anchor\"}, \"#\"\n )\n return self._make_tag(\n f\"h{level}\",\n {\n \"id\": ident,\n \"class\": (\n f\"is-size-{level}-desktop is-size-{level + 2}-touch\"\n ),\n },\n text,\n )\n\n def link(self, text: str, url: str, title: str | None = None) -> str:\n url = self.safe_url(url).replace(\".md\", \".html\")\n url, anchor = url.split(\"#\", 1) if \"#\" in url else (url, None)\n if (\n not url.endswith(\"/\")\n and not url.endswith(\".html\")\n and not url.startswith(\"http\")\n ):\n url += \".html\"\n if anchor:\n url += f\"#{anchor}\"\n attributes: dict[str, str] = {\"href\": url}\n if title:\n attributes[\"title\"] = safe_entity(title)\n if url.startswith(\"http\"):\n attributes[\"target\"] = \"_blank\"\n attributes[\"rel\"] = \"nofollow noreferrer\"\n else:\n attributes[\"hx-get\"] = url\n attributes[\"hx-target\"] = \"#content\"\n attributes[\"hx-swap\"] = \"innerHTML\"\n attributes[\"hx-push-url\"] = \"true\"\n return self._make_tag(\"a\", attributes, text)\n\n def span(self, text, classes, **attrs) -> str:\n if classes:\n attrs[\"class\"] = classes\n return self._make_tag(\"span\", attrs, text)\n\n def list(self, text: str, ordered: bool, **attrs) -> str:\n tag = \"ol\" if ordered else \"ul\"\n attrs[\"class\"] = tag\n return self._make_tag(tag, attrs, text)\n\n def list_item(self, text: str, **attrs) -> str:\n attrs[\"class\"] = \"li\"\n return self._make_tag(\"li\", attrs, text)\n\n def table(self, text: str, **attrs) -> str:\n attrs[\"class\"] = \"table is-fullwidth is-bordered\"\n return self._make_tag(\"table\", attrs, text)\n\n def inline_directive(self, text: str, **attrs) -> str:\n num_dots = text.count(\".\")\n display = self.codespan(text)\n\n if num_dots <= 1:\n return display\n\n module, *_ = text.rsplit(\".\", num_dots - 1)\n href = f\"/api/{module}.html\"\n return self._make_tag(\n \"a\",\n {\"href\": href, \"class\": \"inline-directive\"},\n display,\n )\n\n def _make_tag(\n self, tag: str, attributes: dict[str, str], text: str | None = None\n ) -> str:\n attrs = \" \".join(\n f'{key}=\"{value}\"' for key, value in attributes.items()\n )\n if text is None:\n return f\"<{tag} {attrs} />\"\n return f\"<{tag} {attrs}>{text}\"\n\n\nclass SanicTableOfContents(TableOfContents):\n def generate_heading_id(self, token, index):\n return slugify(token[\"text\"])\n\n\nRST_CODE_BLOCK_PATTERN = re.compile(\n r\"\\.\\.\\scode-block::\\s(\\w+)\\n\\n((?:\\n|(?:\\s\\s\\s\\s[^\\n]*))+)\"\n)\n\n_render_markdown = create_markdown(\n renderer=DocsRenderer(),\n plugins=[\n RSTDirective(\n [\n # Admonition(),\n Attributes(),\n Notification(),\n SanicTableOfContents(),\n Column(),\n Mermaid(),\n Tabs(),\n Hook(),\n ]\n ),\n \"abbr\",\n \"def_list\",\n \"footnotes\",\n \"mark\",\n \"table\",\n span,\n inline_directive,\n ],\n)\n\n\ndef render_markdown(text: str) -> str:\n def replacer(match):\n language = match.group(1)\n code_block = dedent(match.group(2)).strip()\n return f\"```{language}\\n{code_block}\\n```\\n\\n\"\n\n text = RST_CODE_BLOCK_PATTERN.sub(replacer, text)\n return _render_markdown(text)\n" }, { "path": "guide/webapp/display/page/__init__.py", "content": "from .page import Page\nfrom .renderer import PageRenderer\n\n\n__all__ = [\"Page\", \"PageRenderer\"]\n" }, { "path": "guide/webapp/display/page/docobject.py", "content": "from __future__ import annotations\n\nimport importlib\nimport inspect\nimport pkgutil\n\nfrom collections import defaultdict\nfrom dataclasses import dataclass, field\nfrom html import escape\n\nfrom docstring_parser import Docstring, DocstringParam, DocstringRaises\nfrom docstring_parser import parse as parse_docstring\nfrom docstring_parser.common import DocstringExample\nfrom html5tagger import HTML, Builder, E # type: ignore\n\nfrom ..markdown import render_markdown, slugify\n\n\n@dataclass\nclass DocObject:\n name: str\n module_name: str\n full_name: str\n signature: inspect.Signature | None\n docstring: Docstring\n object_type: str = \"\"\n methods: list[DocObject] = field(default_factory=list)\n decorators: list[str] = field(default_factory=list)\n\n\ndef _extract_classes_methods(obj, full_name, docstrings):\n methods = []\n for method_name, method in inspect.getmembers(obj, _is_public_member):\n try:\n signature = _get_method_signature(method)\n docstring = inspect.getdoc(method)\n decorators = _detect_decorators(obj, method)\n methods.append(\n DocObject(\n name=method_name,\n module_name=\"\",\n full_name=f\"{full_name}.{method_name}\",\n signature=signature,\n docstring=parse_docstring(docstring or \"\"),\n decorators=decorators,\n object_type=_get_object_type(method),\n )\n )\n except ValueError:\n pass\n\n docstrings[full_name].methods = methods\n\n\ndef _get_method_signature(method):\n try:\n return inspect.signature(method)\n except TypeError:\n signature = None\n if func := getattr(method, \"fget\", None):\n signature = inspect.signature(func)\n return signature\n\n\ndef _is_public_member(obj: object) -> bool:\n obj_name = getattr(obj, \"__name__\", \"\")\n if func := getattr(obj, \"fget\", None):\n obj_name = getattr(func, \"__name__\", \"\")\n return (\n not obj_name.startswith(\"_\")\n and not obj_name.isupper()\n and (\n inspect.ismethod(obj)\n or inspect.isfunction(obj)\n or isinstance(obj, property)\n or isinstance(obj, property)\n )\n )\n\n\ndef _detect_decorators(cls, method):\n decorators = []\n method_name = getattr(method, \"__name__\", None)\n if isinstance(cls.__dict__.get(method_name), classmethod):\n decorators.append(\"classmethod\")\n if isinstance(cls.__dict__.get(method_name), staticmethod):\n decorators.append(\"staticmethod\")\n if isinstance(method, property):\n decorators.append(\"property\")\n return decorators\n\n\ndef _get_object_type(obj) -> str:\n if inspect.isclass(obj):\n return \"class\"\n\n # If the object is a method, get the underlying function\n if inspect.ismethod(obj):\n obj = obj.__func__\n\n # If the object is a coroutine or a coroutine function\n if inspect.iscoroutine(obj) or inspect.iscoroutinefunction(obj):\n return \"async def\"\n\n return \"def\"\n\n\ndef organize_docobjects(package_name: str) -> dict[str, str]:\n page_content: defaultdict[str, str] = defaultdict(str)\n docobjects = _extract_docobjects(package_name)\n page_registry: defaultdict[str, list[str]] = defaultdict(list)\n for module, docobject in docobjects.items():\n builder = Builder(name=\"Partial\")\n _docobject_to_html(docobject, builder)\n ref = module.rsplit(\".\", module.count(\".\") - 1)[0]\n page_registry[ref].append(module)\n page_content[f\"/api/{ref}.md\"] += str(builder)\n for ref, objects in page_registry.items():\n page_content[f\"/api/{ref}.md\"] = (\n _table_of_contents(objects) + page_content[f\"/api/{ref}.md\"]\n )\n return page_content\n\n\ndef _table_of_contents(objects: list[str]) -> str:\n builder = Builder(name=\"Partial\")\n with builder.div(class_=\"table-of-contents\"):\n builder.h3(\"Table of Contents\", class_=\"is-size-4\")\n for obj in objects:\n module, name = obj.rsplit(\".\", 1)\n builder.a(\n E.strong(name),\n E.small(module),\n href=f\"#{slugify(obj.replace('.', '-'))}\",\n class_=\"table-of-contents-item\",\n )\n return str(builder)\n\n\ndef _extract_docobjects(package_name: str) -> dict[str, DocObject]:\n docstrings = {}\n package = importlib.import_module(package_name)\n\n for _, name, _ in pkgutil.walk_packages(\n package.__path__, package_name + \".\"\n ):\n module = importlib.import_module(name)\n for obj_name, obj in inspect.getmembers(module):\n if (\n obj_name.startswith(\"_\")\n or inspect.getmodule(obj) != module\n or not callable(obj)\n ):\n continue\n try:\n signature = inspect.signature(obj)\n except ValueError:\n signature = None\n docstring = inspect.getdoc(obj)\n full_name = f\"{name}.{obj_name}\"\n docstrings[full_name] = DocObject(\n name=obj_name,\n full_name=full_name,\n module_name=name,\n signature=signature,\n docstring=parse_docstring(docstring or \"\"),\n object_type=_get_object_type(obj),\n )\n if inspect.isclass(obj):\n _extract_classes_methods(obj, full_name, docstrings)\n\n return docstrings\n\n\ndef _docobject_to_html(\n docobject: DocObject, builder: Builder, as_method: bool = False\n) -> None:\n anchor_id = slugify(docobject.full_name.replace(\".\", \"-\"))\n anchor = E.a(\"#\", class_=\"anchor\", href=f\"#{anchor_id}\")\n class_name, heading = _define_heading_and_class(\n docobject, anchor, as_method\n )\n\n with builder.div(class_=class_name):\n builder(heading)\n\n if docobject.docstring.short_description:\n builder.div(\n HTML(render_markdown(docobject.docstring.short_description)),\n class_=\"short-description mt-3 is-size-5\",\n )\n\n if docobject.object_type == \"class\":\n mro = [\n item\n for idx, item in enumerate(\n inspect.getmro(\n getattr(\n importlib.import_module(docobject.module_name),\n docobject.name,\n )\n )\n )\n if idx > 0 and item not in (object, type)\n ]\n if mro:\n builder.div(\n E.span(\"Inherits from: \", class_=\"is-italic\"),\n E.span(\n \", \".join([cls.__name__ for cls in mro]),\n class_=\"has-text-weight-bold\",\n ),\n class_=\"short-description mt-3 is-size-5\",\n )\n\n builder.p(\n HTML(\n _signature_to_html(\n docobject.name,\n docobject.object_type,\n docobject.signature,\n docobject.decorators,\n )\n ),\n class_=\"signature notification is-family-monospace\",\n )\n\n if docobject.docstring.long_description:\n builder.div(\n HTML(render_markdown(docobject.docstring.long_description)),\n class_=\"long-description mt-3\",\n )\n\n if docobject.docstring.params:\n with builder.div(class_=\"box mt-5\"):\n builder.h5(\n \"Parameters\", class_=\"is-size-5 has-text-weight-bold\"\n )\n _render_params(builder, docobject.docstring.params)\n\n if docobject.docstring.returns:\n _render_returns(builder, docobject)\n\n if docobject.docstring.raises:\n _render_raises(builder, docobject.docstring.raises)\n\n if docobject.docstring.examples:\n _render_examples(builder, docobject.docstring.examples)\n\n for method in docobject.methods:\n _docobject_to_html(method, builder, as_method=True)\n\n\ndef _signature_to_html(\n name: str,\n object_type: str,\n signature: inspect.Signature | None,\n decorators: list[str],\n) -> str:\n parts = []\n parts.append(\"\")\n for decorator in decorators:\n parts.append(\n f\"@{decorator}
\"\n )\n parts.append(\n f\"{object_type} \"\n f\"{name}(\"\n )\n if not signature:\n parts.append(\"self)\")\n parts.append(\"\")\n return \"\".join(parts)\n for i, param in enumerate(signature.parameters.values()):\n parts.append(f\"{escape(param.name)}\")\n annotation = \"\"\n if param.annotation != inspect.Parameter.empty:\n annotation = escape(str(param.annotation))\n parts.append(\n f\": {annotation}\"\n )\n if param.default != inspect.Parameter.empty:\n default = escape(str(param.default))\n if annotation == \"str\":\n default = f'\"{default}\"'\n parts.append(f\" = {default}\")\n if i < len(signature.parameters) - 1:\n parts.append(\", \")\n parts.append(\")\")\n if signature.return_annotation != inspect.Signature.empty:\n return_annotation = escape(str(signature.return_annotation))\n parts.append(\n f\": -> {return_annotation}\"\n )\n parts.append(\"\")\n return \"\".join(parts)\n\n\ndef _define_heading_and_class(\n docobject: DocObject, anchor: Builder, as_method: bool\n) -> tuple[str, Builder]:\n anchor_id = slugify(docobject.full_name.replace(\".\", \"-\"))\n anchor = E.a(\"#\", class_=\"anchor\", href=f\"#{anchor_id}\")\n if as_method:\n class_name = \"method\"\n heading = E.h3(\n docobject.name,\n anchor,\n class_=\"is-size-4 has-text-weight-bold mt-6\",\n id_=anchor_id,\n )\n else:\n class_name = \"docobject\"\n heading = E.h2(\n E.span(docobject.module_name, class_=\"has-text-weight-light\"),\n \".\",\n E.span(docobject.name, class_=\"has-text-weight-bold is-size-1\"),\n anchor,\n class_=\"is-size-2\",\n id_=anchor_id,\n )\n return class_name, heading\n\n\ndef _render_params(builder: Builder, params: list[DocstringParam]) -> None:\n for param in params:\n with builder.dl(class_=\"mt-2\"):\n dt_args = [param.arg_name]\n if param.type_name:\n parts = [\n E.br(),\n E.span(\n param.type_name,\n class_=(\n \"has-text-weight-normal has-text-purple \"\n \"is-size-7 ml-2\"\n ),\n ),\n ]\n dt_args.extend(parts)\n builder.dt(*dt_args, class_=\"is-family-monospace\")\n builder.dd(\n HTML(\n render_markdown(\n param.description\n or param.arg_name\n or param.type_name\n or \"\"\n )\n )\n )\n\n\ndef _render_raises(builder: Builder, raises: list[DocstringRaises]) -> None:\n with builder.div(class_=\"box mt-5\"):\n builder.h5(\"Raises\", class_=\"is-size-5 has-text-weight-bold\")\n for raise_ in raises:\n with builder.dl(class_=\"mt-2\"):\n builder.dt(raise_.type_name, class_=\"is-family-monospace\")\n builder.dd(\n HTML(\n render_markdown(\n raise_.description or raise_.type_name or \"\"\n )\n )\n )\n\n\ndef _render_returns(builder: Builder, docobject: DocObject) -> None:\n assert docobject.docstring.returns\n return_type = docobject.docstring.returns.type_name\n if not return_type or return_type == \"None\":\n return\n with builder.div(class_=\"box mt-5\"):\n if not return_type and docobject.signature:\n return_type = docobject.signature.return_annotation\n\n if not return_type or return_type == inspect.Signature.empty:\n return_type = \"N/A\"\n\n term = (\n \"Return\"\n if not docobject.docstring.returns.is_generator\n else \"Yields\"\n )\n builder.h5(term, class_=\"is-size-5 has-text-weight-bold\")\n with builder.dl(class_=\"mt-2\"):\n builder.dt(return_type, class_=\"is-family-monospace\")\n builder.dd(\n HTML(\n render_markdown(\n docobject.docstring.returns.description\n or docobject.docstring.returns.type_name\n or \"\"\n )\n )\n )\n\n\ndef _render_examples(\n builder: Builder, examples: list[DocstringExample]\n) -> None:\n with builder.div(class_=\"box mt-5\"):\n builder.h5(\"Examples\", class_=\"is-size-5 has-text-weight-bold\")\n for example in examples:\n with builder.div(class_=\"mt-2\"):\n builder(\n HTML(\n render_markdown(\n example.description or example.snippet or \"\"\n )\n )\n )\n" }, { "path": "guide/webapp/display/page/page.py", "content": "from __future__ import annotations\n\nfrom dataclasses import dataclass, field\nfrom pathlib import Path\n\nfrom frontmatter import parse\n\nfrom ..layouts.base import BaseLayout\nfrom ..layouts.home import HomeLayout\nfrom ..layouts.main import MainLayout\nfrom ..markdown import render_markdown\nfrom .docobject import organize_docobjects\n\n\n_PAGE_CACHE: dict[\n str, dict[str, tuple[Page | None, Page | None, Page | None]]\n] = {}\n_LAYOUTS_CACHE: dict[str, type[BaseLayout]] = {\n \"home\": HomeLayout,\n \"main\": MainLayout,\n}\n_DEFAULT = \"en\"\n\n\n@dataclass\nclass PageMeta:\n language: str = _DEFAULT\n title: str = \"\"\n description: str = \"\"\n layout: str = \"main\"\n features: list[dict[str, str]] = field(default_factory=list)\n content_class: str = \"\"\n\n\n@dataclass\nclass Page:\n path: Path\n content: str\n meta: PageMeta = field(default_factory=PageMeta)\n _relative_path: Path | None = None\n next_page: Page | None = None\n previous_page: Page | None = None\n anchors: list[str] = field(default_factory=list)\n\n DEFAULT_LANGUAGE = _DEFAULT\n\n def get_layout(self) -> type[BaseLayout]:\n return _LAYOUTS_CACHE[self.meta.layout]\n\n @property\n def relative_path(self) -> Path:\n if self._relative_path is None:\n raise RuntimeError(\"Page not initialized\")\n return self._relative_path\n\n @classmethod\n def get(\n cls, language: str, path: str\n ) -> tuple[Page | None, Page | None, Page | None]:\n if path.endswith(\"/\") or not path:\n path += \"index.html\"\n if not path.endswith(\".md\"):\n path = path.removesuffix(\".html\") + \".md\"\n if language == \"api\":\n path = f\"/api/{path}\"\n return _PAGE_CACHE.get(language, {}).get(path, (None, None, None))\n\n @classmethod\n def load_pages(cls, base_path: Path, page_order: list[str]) -> list[Page]:\n output: list[Page] = []\n for path in base_path.glob(\"**/*.md\"):\n relative = path.relative_to(base_path)\n language = relative.parts[0]\n name = \"/\".join(relative.parts[1:])\n page = cls._load_page(path)\n output.append(page)\n page._relative_path = relative\n _PAGE_CACHE.setdefault(language, {})[name] = (\n None,\n page,\n None,\n )\n _PAGE_CACHE[\"api\"] = {}\n for language, pages in _PAGE_CACHE.items():\n for name, (_, current, _) in pages.items():\n previous_page = None\n next_page = None\n try:\n index = page_order.index(name)\n except ValueError:\n continue\n try:\n if index > 0:\n previous_page = pages[page_order[index - 1]][1]\n except KeyError:\n pass\n try:\n if index < len(page_order) - 1:\n next_page = pages[page_order[index + 1]][1]\n except KeyError:\n pass\n pages[name] = (previous_page, current, next_page)\n previous_page = None\n next_page = None\n\n api_pages = cls._load_api_pages()\n filtered_order = [ref for ref in page_order if ref in api_pages]\n for idx, ref in enumerate(filtered_order):\n current_page = api_pages[ref]\n previous_page = None\n next_page = None\n try:\n if idx > 0:\n previous_page = api_pages[filtered_order[idx - 1]]\n except KeyError:\n pass\n try:\n if idx < len(filtered_order) - 1:\n next_page = api_pages[filtered_order[idx + 1]]\n except KeyError:\n pass\n _PAGE_CACHE[\"api\"][ref] = (previous_page, current_page, next_page)\n\n return output\n\n @staticmethod\n def _load_page(path: Path) -> Page:\n raw = path.read_text()\n metadata, raw_content = parse(raw)\n content = render_markdown(raw_content)\n page = Page(\n path=path,\n content=content,\n meta=PageMeta(**metadata),\n )\n if not page.meta.title:\n page.meta.title = page.path.stem.replace(\"-\", \" \").title()\n\n for line in raw.splitlines():\n if line.startswith(\"##\") and not line.startswith(\"###\"):\n line = line.lstrip(\"#\").strip()\n page.anchors.append(line)\n\n return page\n\n @staticmethod\n def _load_api_pages() -> dict[str, Page]:\n docstring_content = organize_docobjects(\"sanic\")\n output: dict[str, Page] = {}\n\n for module, content in docstring_content.items():\n path = Path(module)\n page = Page(\n path=path,\n content=content,\n meta=PageMeta(\n title=path.stem,\n description=\"\",\n layout=\"main\",\n ),\n )\n page._relative_path = Path(f\"./{module}\")\n output[module] = page\n\n return output\n" }, { "path": "guide/webapp/display/page/renderer.py", "content": "from __future__ import annotations\n\nfrom contextlib import contextmanager\n\nfrom html5tagger import HTML, Builder # type: ignore\n\nfrom sanic import Request\nfrom webapp.display.base import BaseRenderer\n\nfrom ..layouts.base import BaseLayout\nfrom .page import Page\n\n\nclass PageRenderer(BaseRenderer):\n def render(self, request: Request, language: str, path: str) -> Builder:\n self._setup_request(request, language, path)\n builder = self.get_builder(\n full=request.headers.get(\"HX-Request\") is None,\n language=language,\n )\n self._body(request, builder, language, path)\n return builder\n\n def title(self) -> str:\n request = Request.get_current()\n title: str | None = None\n if request and (\n current_page := getattr(request.ctx, \"current_page\", None)\n ):\n title = f\"{self.base_title} - {current_page.meta.title}\"\n return title or self.base_title\n\n def _setup_request(self, request: Request, language: str, path: str):\n prev_page, current_page, next_page = Page.get(language, path)\n request.ctx.language = (\n Page.DEFAULT_LANGUAGE if language == \"api\" else language\n )\n request.ctx.current_page = current_page\n request.ctx.previous_page = prev_page\n request.ctx.next_page = next_page\n\n def _body(\n self, request: Request, builder: Builder, language: str, path: str\n ):\n current_page = request.ctx.current_page\n with self._base(request, builder, current_page):\n if current_page is None:\n builder.h1(\"Not found\")\n return\n builder(HTML(current_page.content))\n\n @contextmanager\n def _base(self, request: Request, builder: Builder, page: Page | None):\n layout_type: type[BaseLayout] = (\n page.get_layout() if page else BaseLayout\n )\n layout = layout_type(builder)\n with layout(request, builder.full):\n yield\n" }, { "path": "guide/webapp/display/plugins/__init__.py", "content": "" }, { "path": "guide/webapp/display/plugins/attrs.py", "content": "from re import Match\nfrom textwrap import dedent\nfrom typing import Any\n\nfrom html5tagger import HTML, E\nfrom mistune.block_parser import BlockParser\nfrom mistune.core import BlockState\nfrom mistune.directives import DirectivePlugin\n\n\nclass Attributes(DirectivePlugin):\n def __call__(self, directive, md):\n directive.register(\"attrs\", self.parse)\n\n if md.renderer.NAME == \"html\":\n md.renderer.register(\"attrs\", self._render)\n\n def parse(\n self, block: BlockParser, m: Match, state: BlockState\n ) -> dict[str, Any]:\n info = m.groupdict()\n options = dict(self.parse_options(m))\n new_state = block.state_cls()\n new_state.process(dedent(info[\"text\"]))\n block.parse(new_state)\n options.setdefault(\"class_\", \"additional-attributes\")\n classes = options.pop(\"class\", \"\")\n if classes:\n options[\"class_\"] += f\" {classes}\"\n\n return {\n \"type\": \"attrs\",\n \"text\": info[\"text\"],\n \"children\": new_state.tokens,\n \"attrs\": options,\n }\n\n def _render(self, _, text: str, **attrs) -> str:\n return str(E.div(HTML(text), **attrs))\n" }, { "path": "guide/webapp/display/plugins/columns.py", "content": "from re import Match\nfrom textwrap import dedent\nfrom typing import Any\n\nfrom mistune import HTMLRenderer\nfrom mistune.block_parser import BlockParser\nfrom mistune.core import BlockState\nfrom mistune.directives import DirectivePlugin, RSTDirective\nfrom mistune.markdown import Markdown\n\n\nclass Column(DirectivePlugin):\n def parse(\n self, block: BlockParser, m: Match, state: BlockState\n ) -> dict[str, Any]:\n info = m.groupdict()\n\n new_state = block.state_cls()\n new_state.process(dedent(info[\"text\"]))\n block.parse(new_state)\n\n return {\n \"type\": \"column\",\n \"text\": info[\"text\"],\n \"children\": new_state.tokens,\n \"attrs\": {},\n }\n\n def __call__( # type: ignore\n self, directive: RSTDirective, md: Markdown\n ) -> None:\n directive.register(\"column\", self.parse)\n\n if md.renderer.NAME == \"html\":\n md.renderer.register(\"column\", self._render_column)\n\n def _render_column(self, renderer: HTMLRenderer, text: str, **attrs):\n start = (\n '
\\n'\n if attrs.get(\"first\")\n else \"\"\n )\n end = \"
\\n\" if attrs.get(\"last\") else \"\"\n col = f'
{text}
\\n'\n return start + (col) + end\n" }, { "path": "guide/webapp/display/plugins/hook.py", "content": "from mistune.core import BlockState\nfrom mistune.directives import DirectivePlugin, RSTDirective\nfrom mistune.markdown import Markdown\n\n\nclass Hook(DirectivePlugin):\n def __call__( # type: ignore\n self, directive: RSTDirective, md: Markdown\n ) -> None:\n if md.renderer.NAME == \"html\":\n md.before_render_hooks.append(self._hook)\n\n def _hook(self, md: Markdown, state: BlockState) -> None:\n prev = None\n for idx, token in enumerate(state.tokens):\n for type_ in (\"column\", \"tab\"):\n if token[\"type\"] == type_:\n maybe_next = (\n state.tokens[idx + 1]\n if idx + 1 < len(state.tokens)\n else None\n )\n token.setdefault(\"attrs\", {})\n if prev and prev[\"type\"] != type_:\n token[\"attrs\"][\"first\"] = True\n if (\n maybe_next and maybe_next[\"type\"] != type_\n ) or not maybe_next:\n token[\"attrs\"][\"last\"] = True\n\n prev = token\n" }, { "path": "guide/webapp/display/plugins/inline_directive.py", "content": "import re\n\nfrom mistune.markdown import Markdown\n\n\nDIRECTIVE_PATTERN = r\":(?:class|func|meth|attr|exc|mod|data|const|obj|keyword|option|cmdoption|envvar):`(?Psanic\\.[^`]+)`\" # noqa: E501\n\n\ndef _parse_inline_directive(inline, m: re.Match, state):\n state.append_token(\n {\n \"type\": \"inline_directive\",\n \"attrs\": {},\n \"raw\": m.group(\"ref\"),\n }\n )\n return m.end()\n\n\ndef inline_directive(md: Markdown):\n md.inline.register(\n \"inline_directive\",\n DIRECTIVE_PATTERN,\n _parse_inline_directive,\n before=\"escape\",\n )\n" }, { "path": "guide/webapp/display/plugins/mermaid.py", "content": "from html import unescape\nfrom re import Match\nfrom textwrap import dedent\nfrom typing import Any\n\nfrom html5tagger import HTML, E\nfrom mistune import HTMLRenderer\nfrom mistune.block_parser import BlockParser\nfrom mistune.core import BlockState\nfrom mistune.directives import DirectivePlugin, RSTDirective\nfrom mistune.markdown import Markdown\n\n\nclass Mermaid(DirectivePlugin):\n def parse(\n self, block: BlockParser, m: Match, state: BlockState\n ) -> dict[str, Any]:\n info = m.groupdict()\n\n new_state = block.state_cls()\n new_state.process(dedent(info[\"text\"]))\n block.parse(new_state)\n\n text = HTML(info[\"text\"].strip())\n\n return {\n \"type\": \"mermaid\",\n \"text\": text,\n \"children\": [{\"type\": \"text\", \"text\": text}],\n \"attrs\": {},\n }\n\n def __call__(self, directive: RSTDirective, md: Markdown) -> None: # type: ignore\n directive.register(\"mermaid\", self.parse)\n\n if md.renderer.NAME == \"html\":\n md.renderer.register(\"mermaid\", self._render_mermaid)\n\n def _render_mermaid(self, renderer: HTMLRenderer, text: str, **attrs):\n return str(E.div(class_=\"mermaid\")(HTML(unescape(text))))\n" }, { "path": "guide/webapp/display/plugins/notification.py", "content": "from html5tagger import HTML, E\nfrom mistune.directives import Admonition\n\n\nclass Notification(Admonition):\n SUPPORTED_NAMES = {\n \"success\",\n \"info\",\n \"warning\",\n \"danger\",\n \"tip\",\n \"new\",\n \"note\",\n }\n\n def __call__(self, directive, md):\n for name in self.SUPPORTED_NAMES:\n directive.register(name, self.parse)\n\n if md.renderer.NAME == \"html\":\n md.renderer.register(\"admonition\", self._render_admonition)\n md.renderer.register(\n \"admonition_title\", self._render_admonition_title\n )\n md.renderer.register(\n \"admonition_content\", self._render_admonition_content\n )\n\n def _render_admonition(self, _, text, name, **attrs) -> str:\n return str(\n E.div(\n HTML(text),\n class_=f\"notification is-{name}\",\n )\n )\n\n def _render_admonition_title(self, _, text) -> str:\n return str(\n E.p(\n text,\n class_=\"notification-title\",\n )\n )\n\n def _render_admonition_content(self, _, text) -> str:\n return text\n" }, { "path": "guide/webapp/display/plugins/span.py", "content": "import re\n\nfrom mistune.markdown import Markdown\n\n\ndef parse_inline_span(inline, m: re.Match, state):\n state.append_token(\n {\n \"type\": \"span\",\n \"attrs\": {\"classes\": m.group(\"classes\")},\n \"raw\": m.group(\"content\"),\n }\n )\n return m.end()\n\n\nSPAN_PATTERN = r\"{span:(?:(?P[^\\:]+?):)?(?P.*?)}\"\n\n\ndef span(md: Markdown) -> None:\n md.inline.register(\n \"span\",\n SPAN_PATTERN,\n parse_inline_span,\n before=\"link\",\n )\n" }, { "path": "guide/webapp/display/plugins/tabs.py", "content": "from re import Match\nfrom textwrap import dedent\nfrom typing import Any\n\nfrom mistune import HTMLRenderer\nfrom mistune.block_parser import BlockParser\nfrom mistune.core import BlockState\nfrom mistune.directives import DirectivePlugin, RSTDirective\nfrom mistune.markdown import Markdown\n\n\nclass Tabs(DirectivePlugin):\n def parse(\n self, block: BlockParser, m: Match, state: BlockState\n ) -> dict[str, Any]:\n info = m.groupdict()\n\n new_state = block.state_cls()\n new_state.process(dedent(info[\"text\"]))\n block.parse(new_state)\n\n return {\n \"type\": \"tab\",\n \"text\": info[\"text\"],\n \"children\": new_state.tokens,\n \"attrs\": {\n \"title\": info[\"title\"],\n },\n }\n\n def __call__( # type: ignore\n self,\n directive: RSTDirective,\n md: Markdown,\n ) -> None:\n directive.register(\"tab\", self.parse)\n\n if md.renderer.NAME == \"html\":\n md.renderer.register(\"tab\", self._render_tab)\n\n def _render_tab(self, renderer: HTMLRenderer, text: str, **attrs):\n start = (\n '
    \\n'\n if attrs.get(\"first\")\n else \"\"\n )\n end = (\n '
\\n'\n if attrs.get(\"last\")\n else \"\"\n )\n content = f'
{text}
\\n'\n tab = f\"
  • {attrs['title']}{content}
    • \\n\"\n return start + tab + end\n" }, { "path": "guide/webapp/display/search/__init__.py", "content": "" }, { "path": "guide/webapp/display/search/renderer.py", "content": "from contextlib import contextmanager\nfrom urllib.parse import unquote\n\nfrom html5tagger import Builder, E # type: ignore\n\nfrom sanic import Request\nfrom webapp.display.search.search import Searcher\n\nfrom ..base import BaseRenderer\nfrom ..layouts.main import MainLayout\n\n\nclass SearchRenderer(BaseRenderer):\n def render(\n self, request: Request, language: str, searcher: Searcher, full: bool\n ) -> Builder:\n builder = self.get_builder(\n full=request.headers.get(\"HX-Request\") is None,\n language=language,\n )\n self._body(request, builder, language, searcher, full)\n return builder\n\n def _body(\n self,\n request: Request,\n builder: Builder,\n language: str,\n searcher: Searcher,\n full: bool,\n ):\n with self._base(request, builder, full):\n builder.h1(\"Search\")\n self._results(request, builder, searcher, language)\n\n @contextmanager\n def _base(self, request: Request, builder: Builder, full: bool):\n layout = MainLayout(builder)\n with layout(request, full):\n yield\n\n def _results(\n self,\n request: Request,\n builder: Builder,\n searcher: Searcher,\n language: str,\n ):\n query = unquote(request.args.get(\"q\", \"\"))\n results = searcher.search(query, language)\n if not query or not results:\n builder.p(\"No results found\")\n return\n\n with builder.div(class_=\"container\"):\n with builder.ul():\n for _, doc in results:\n builder.li(\n E.a(\n doc.title,\n href=f\"/{doc.page.relative_path}\",\n hx_get=f\"/{doc.page.relative_path}\",\n hx_target=\"#content\",\n hx_swap=\"innerHTML\",\n hx_push_url=\"true\",\n ),\n f\" - {doc.page.relative_path}\",\n )\n" }, { "path": "guide/webapp/display/search/search.py", "content": "from __future__ import annotations\n\nfrom collections import Counter\nfrom pathlib import Path\nfrom typing import ClassVar\n\nfrom msgspec import Struct\n\nfrom webapp.display.page import Page\n\n\nclass Stemmer:\n STOP_WORDS: ClassVar[set[str]] = set(\n \"a about above after again against all am an and any are aren't as at be because been before being below between both but by can't cannot could couldn't did didn't do does doesn't doing don't down during each few for from further had hadn't has hasn't have haven't having he he'd he'll he's her here here's hers herself him himself his how how's i i'd i'll i'm i've if in into is isn't it it's its itself let's me more most mustn't my myself no nor not of off on once only or other ought our ours ourselves out over own same shan't she she'd she'll she's should shouldn't so some such than that that's the their theirs them themselves then there there's these they they'd they'll they're they've this those through to too under until up very was wasn't we we'd we'll we're we've were weren't what what's when when's where where's which while who who's whom why why's with won't would wouldn't you you'd you'll you're you've your yours yourself yourselves\".split() # noqa: E501\n )\n PREFIXES = set(\"auto be fore over re un under\".split())\n SUFFIXES = set(\n \"able al ance ant ate ed en er ful hood ing ion ish ity ive ize less ly ment ness ous ship sion tion y\".split() # noqa: E501\n )\n VOWELS = set(\"aeiou\")\n PLURALIZATION = set(\"s es ies\".split())\n\n def stem(self, word: str) -> str:\n if word in self.STOP_WORDS:\n return word\n if word in self.PREFIXES:\n return word\n for suffix in self.SUFFIXES | self.PLURALIZATION:\n if word.endswith(suffix):\n return self._stem(word[: -len(suffix)])\n return word\n\n def _stem(self, word: str) -> str:\n if word.endswith(\"e\"):\n return word[:-1]\n if word.endswith(\"y\") and word[-2] not in self.VOWELS:\n return word[:-1]\n return word\n\n def __call__(self, word: str) -> str:\n return self.stem(word)\n\n\nclass Document(Struct, kw_only=True):\n TITLE_WEIGHT: ClassVar[int] = 3\n BODY_WEIGHT: ClassVar[int] = 1\n\n page: Page\n language: str\n term_frequency: dict[str, float] = {}\n\n @property\n def title(self) -> str:\n return self.page.meta.title\n\n @property\n def text(self) -> str:\n return self.page.content\n\n @property\n def weighted_text(self) -> str:\n \"\"\"Return the text with the title repeated.\"\"\"\n return \" \".join(\n [self.title] * self.TITLE_WEIGHT + [self.text] * self.BODY_WEIGHT\n )\n\n def _term_frequency(self, stemmer: Stemmer) -> None:\n \"\"\"Count the number of times each word appears in the document.\"\"\"\n words = [\n stemmer(word)\n for word in self.weighted_text.lower().split()\n if word not in Stemmer.STOP_WORDS\n ]\n num_words = len(words)\n word_count = Counter(words)\n self.term_frequency = {\n word: count / num_words for word, count in word_count.items()\n }\n\n def process(self, stemmer: Stemmer) -> Document:\n \"\"\"Process the document.\"\"\"\n self._term_frequency(stemmer)\n return self\n\n\ndef _inverse_document_frequency(docs: list[Document]) -> dict[str, float]:\n \"\"\"Count the number of documents each word appears in.\"\"\"\n num_docs = len(docs)\n word_count: Counter[str] = Counter()\n for doc in docs:\n word_count.update(doc.term_frequency.keys())\n return {word: num_docs / count for word, count in word_count.items()}\n\n\ndef _tf_idf_vector(\n document: Document, idf: dict[str, float]\n) -> dict[str, float]:\n \"\"\"Calculate the TF-IDF vector for a document.\"\"\"\n return {\n word: tf * idf[word]\n for word, tf in document.term_frequency.items()\n if word in idf\n }\n\n\ndef _cosine_similarity(\n vec1: dict[str, float], vec2: dict[str, float]\n) -> float:\n \"\"\"Calculate the cosine similarity between two vectors.\"\"\"\n if not vec1 or not vec2:\n return 0.0\n dot_product = sum(vec1.get(word, 0) * vec2.get(word, 0) for word in vec1)\n magnitude1 = sum(value**2 for value in vec1.values()) ** 0.5\n magnitude2 = sum(value**2 for value in vec2.values()) ** 0.5\n return dot_product / (magnitude1 * magnitude2)\n\n\ndef _search(\n query: str,\n language: str,\n vectors: list[dict[str, float]],\n idf: dict[str, float],\n documents: list[Document],\n stemmer: Stemmer,\n) -> list[tuple[float, Document]]:\n dummy_page = Page(Path(), query)\n tf_idf_query = _tf_idf_vector(\n Document(page=dummy_page, language=language).process(stemmer), idf\n )\n similarities = [\n _cosine_similarity(tf_idf_query, vector) for vector in vectors\n ]\n return [\n (similarity, document)\n for similarity, document in sorted(\n zip(similarities, documents),\n reverse=True,\n key=lambda pair: pair[0],\n )[:10]\n if similarity > 0\n ]\n\n\nclass Searcher:\n def __init__(\n self,\n stemmer: Stemmer,\n documents: list[Document],\n ):\n self._documents: dict[str, list[Document]] = {}\n for document in documents:\n self._documents.setdefault(document.language, []).append(document)\n self._idf = {\n language: _inverse_document_frequency(documents)\n for language, documents in self._documents.items()\n }\n self._vectors = {\n language: [\n _tf_idf_vector(document, self._idf[language])\n for document in documents\n ]\n for language, documents in self._documents.items()\n }\n self._stemmer = stemmer\n\n def search(\n self, query: str, language: str\n ) -> list[tuple[float, Document]]:\n return _search(\n query,\n language,\n self._vectors[language],\n self._idf[language],\n self._documents[language],\n self._stemmer,\n )\n" }, { "path": "guide/webapp/display/text.py", "content": "import re\n\n\nSLUGIFY_PATTERN = re.compile(r\"[^a-zA-Z0-9-]\")\n\n\ndef slugify(text: str) -> str:\n return SLUGIFY_PATTERN.sub(\"\", text.lower().replace(\" \", \"-\"))\n" }, { "path": "guide/webapp/endpoint/__init__.py", "content": "" }, { "path": "guide/webapp/endpoint/search.py", "content": "# from urllib.parse import unquote\n\nfrom sanic import Blueprint, Request, Sanic, html\nfrom webapp.display.page import Page\nfrom webapp.display.search.renderer import SearchRenderer\nfrom webapp.display.search.search import Document, Searcher, Stemmer\n\n\nbp = Blueprint(\"search\", url_prefix=\"//search\")\n\n\n@bp.get(\"\")\nasync def _search(request: Request, language: str, searcher: Searcher):\n full = not bool(request.headers.get(\"HX-Request\"))\n renderer = SearchRenderer(\"Sanic Documentation Search\")\n builder = renderer.render(request, language, searcher, full)\n\n return html(str(builder))\n\n\n@bp.before_server_start\nasync def setup_search(app: Sanic):\n stemmer = Stemmer()\n pages: list[Page] = app.ctx.pages\n documents = [\n Document(page=page, language=page.meta.language).process(stemmer)\n for page in pages\n ]\n app.ext.dependency(Searcher(stemmer, documents))\n" }, { "path": "guide/webapp/endpoint/sitemap.py", "content": "from sanic import Request, Sanic, raw\n\n\ndef setup_sitemap(app: Sanic) -> None:\n app.get(\"/sitemap.xml\")(_sitemap)\n app.before_server_start(_compile_sitemap, priority=0)\n\n\nasync def _compile_sitemap(app: Sanic):\n pages: list[str] = [\n app.url_for(\n \"page\",\n language=\"en\",\n path=page.relative_path.with_suffix(\".html\"),\n _external=True,\n _server=\"sanic.dev\",\n _scheme=\"https\",\n )\n for page in app.ctx.pages\n if page.relative_path\n ]\n sitemap_parts: list[str] = [\n '',\n '',\n *[f\"{page}\" for page in pages],\n \"\",\n ]\n app.ctx.sitemap = \"\\n\".join(sitemap_parts)\n\n\nasync def _sitemap(request: Request):\n return raw(request.app.ctx.sitemap, content_type=\"application/xml\")\n" }, { "path": "guide/webapp/endpoint/view.py", "content": "from sanic import Blueprint\n\nfrom .search import bp as search_bp\n\n\nbp = Blueprint.group(search_bp)\n" }, { "path": "guide/webapp/worker/__init__.py", "content": "" }, { "path": "guide/webapp/worker/config.py", "content": "from pathlib import Path\n\nfrom msgspec import yaml\n\nfrom webapp.display.layouts.models import GeneralConfig, MenuItem\n\n\ndef load_menu(path: Path) -> list[MenuItem]:\n loaded = yaml.decode(path.read_bytes(), type=dict[str, list[MenuItem]])\n return loaded[\"root\"]\n\n\ndef load_config(path: Path) -> GeneralConfig:\n loaded = yaml.decode(path.read_bytes(), type=GeneralConfig)\n return loaded\n" }, { "path": "guide/webapp/worker/factory.py", "content": "from pathlib import Path\n\nfrom sanic import Request, Sanic, html, redirect\nfrom webapp.display.layouts.models import MenuItem\nfrom webapp.display.page import Page, PageRenderer\nfrom webapp.endpoint.sitemap import setup_sitemap\nfrom webapp.endpoint.view import bp\nfrom webapp.worker.config import load_config, load_menu\nfrom webapp.worker.reload import setup_livereload\nfrom webapp.worker.style import setup_style\n\n\nKNOWN_REDIRECTS = {\n \"guide/deployment/configuration.html\": \"guide/running/configuration.html\",\n \"guide/deployment/development.html\": \"guide/running/development.html\",\n \"guide/deployment/running.html\": \"guide/running/running.html\",\n \"guide/deployment/manager.html\": \"guide/running/manager.html\",\n \"guide/deployment/app-loader.html\": \"guide/running/app-loader.html\",\n \"guide/deployment/inspector.html\": \"guide/running/inspector.html\",\n \"org/policies.html\": \"organization/policies.html\",\n \"org/scope.html\": \"organization/scope.html\",\n \"org/feature_requests.html\": \"\",\n}\n\n\ndef _compile_sidebar_order(items: list[MenuItem]) -> list[str]:\n order = []\n for item in items:\n if item.path:\n order.append(item.path.removesuffix(\".html\") + \".md\")\n if item.items:\n order.extend(_compile_sidebar_order(item.items))\n return order\n\n\ndef create_app(root: Path) -> Sanic:\n app = Sanic(\"Documentation\")\n app.config.PUBLIC_DIR = root / \"public\"\n app.config.CONTENT_DIR = root / \"content\"\n app.config.CONFIG_DIR = root / \"config\"\n app.config.STYLE_DIR = root / \"style\"\n app.config.NODE_MODULES_DIR = root / \"node_modules\"\n app.config.LANGUAGES = [\"en\"]\n app.config.SIDEBAR = load_menu(\n app.config.CONFIG_DIR / \"en\" / \"sidebar.yaml\"\n )\n app.config.NAVBAR = load_menu(app.config.CONFIG_DIR / \"en\" / \"navbar.yaml\")\n app.config.GENERAL = load_config(\n app.config.CONFIG_DIR / \"en\" / \"general.yaml\"\n )\n\n setup_livereload(app)\n setup_style(app)\n setup_sitemap(app)\n app.blueprint(bp)\n\n app.static(\"/assets/\", app.config.PUBLIC_DIR / \"assets\", name=\"assets\")\n\n for path in (app.config.PUBLIC_DIR / \"web\").glob(\"*\"):\n app.static(f\"/{path.name}\", path, name=path.name)\n\n @app.before_server_start(priority=1)\n async def setup(app: Sanic):\n app.ext.dependency(PageRenderer(base_title=\"Sanic User Guide\"))\n page_order = _compile_sidebar_order(app.config.SIDEBAR)\n app.ctx.pages = Page.load_pages(app.config.CONTENT_DIR, page_order)\n app.ctx.get_page = Page.get\n\n @app.get(\"/\", name=\"root\")\n @app.get(\"/index.html\", name=\"index\")\n async def index(request: Request):\n return redirect(request.app.url_for(\"page\", language=\"en\", path=\"\"))\n\n @app.get(\"/\", name=\"page-without-path\")\n @app.get(\"//\")\n async def page(\n request: Request,\n page_renderer: PageRenderer,\n language: str,\n path: str = \"\",\n ):\n # TODO: Add more language support\n if language != \"api\" and language not in app.config.LANGUAGES:\n return redirect(\n request.app.url_for(\"page\", language=\"en\", path=path)\n )\n if path in KNOWN_REDIRECTS:\n return redirect(\n request.app.url_for(\n \"page\", language=language, path=KNOWN_REDIRECTS[path]\n ),\n status=301,\n )\n builder = page_renderer.render(request, language, path)\n title_text = page_renderer.title()\n return html(\n str(builder),\n headers={\n \"vary\": \"hx-request\",\n \"x-title\": title_text,\n },\n )\n\n @app.on_request\n async def set_language(request: Request):\n request.ctx.language = request.match_info.get(\n \"language\", Page.DEFAULT_LANGUAGE\n )\n\n return app\n" }, { "path": "guide/webapp/worker/livereload.js", "content": "(function(){function r(e,n,t){function o(i,f){if(!n[i]){if(!e[i]){var c=\"function\"==typeof require&&require;if(!f&&c)return c(i,!0);if(u)return u(i,!0);var a=new Error(\"Cannot find module '\"+i+\"'\");throw a.code=\"MODULE_NOT_FOUND\",a}var p=n[i]={exports:{}};e[i][0].call(p.exports,function(r){var n=e[i][1][r];return o(n||r)},p,p.exports,r,e,n,t)}return n[i].exports}for(var u=\"function\"==typeof require&&require,i=0;i Array#indexOf\n// true -> Array#includes\nvar toIObject = require('./_to-iobject');\nvar toLength = require('./_to-length');\nvar toAbsoluteIndex = require('./_to-absolute-index');\nmodule.exports = function (IS_INCLUDES) {\n return function ($this, el, fromIndex) {\n var O = toIObject($this);\n var length = toLength(O.length);\n var index = toAbsoluteIndex(fromIndex, length);\n var value;\n // Array#includes uses SameValueZero equality algorithm\n // eslint-disable-next-line no-self-compare\n if (IS_INCLUDES && el != el) while (length > index) {\n value = O[index++];\n // eslint-disable-next-line no-self-compare\n if (value != value) return true;\n // Array#indexOf ignores holes, Array#includes - not\n } else for (;length > index; index++) if (IS_INCLUDES || index in O) {\n if (O[index] === el) return IS_INCLUDES || index || 0;\n } return !IS_INCLUDES && -1;\n };\n};\n\n},{\"./_to-absolute-index\":72,\"./_to-iobject\":74,\"./_to-length\":75}],6:[function(require,module,exports){\n// 0 -> Array#forEach\n// 1 -> Array#map\n// 2 -> Array#filter\n// 3 -> Array#some\n// 4 -> Array#every\n// 5 -> Array#find\n// 6 -> Array#findIndex\nvar ctx = require('./_ctx');\nvar IObject = require('./_iobject');\nvar toObject = require('./_to-object');\nvar toLength = require('./_to-length');\nvar asc = require('./_array-species-create');\nmodule.exports = function (TYPE, $create) {\n var IS_MAP = TYPE == 1;\n var IS_FILTER = TYPE == 2;\n var IS_SOME = TYPE == 3;\n var IS_EVERY = TYPE == 4;\n var IS_FIND_INDEX = TYPE == 6;\n var NO_HOLES = TYPE == 5 || IS_FIND_INDEX;\n var create = $create || asc;\n return function ($this, callbackfn, that) {\n var O = toObject($this);\n var self = IObject(O);\n var f = ctx(callbackfn, that, 3);\n var length = toLength(self.length);\n var index = 0;\n var result = IS_MAP ? create($this, length) : IS_FILTER ? create($this, 0) : undefined;\n var val, res;\n for (;length > index; index++) if (NO_HOLES || index in self) {\n val = self[index];\n res = f(val, index, O);\n if (TYPE) {\n if (IS_MAP) result[index] = res; // map\n else if (res) switch (TYPE) {\n case 3: return true; // some\n case 5: return val; // find\n case 6: return index; // findIndex\n case 2: result.push(val); // filter\n } else if (IS_EVERY) return false; // every\n }\n }\n return IS_FIND_INDEX ? -1 : IS_SOME || IS_EVERY ? IS_EVERY : result;\n };\n};\n\n},{\"./_array-species-create\":8,\"./_ctx\":13,\"./_iobject\":31,\"./_to-length\":75,\"./_to-object\":76}],7:[function(require,module,exports){\nvar isObject = require('./_is-object');\nvar isArray = require('./_is-array');\nvar SPECIES = require('./_wks')('species');\n\nmodule.exports = function (original) {\n var C;\n if (isArray(original)) {\n C = original.constructor;\n // cross-realm fallback\n if (typeof C == 'function' && (C === Array || isArray(C.prototype))) C = undefined;\n if (isObject(C)) {\n C = C[SPECIES];\n if (C === null) C = undefined;\n }\n } return C === undefined ? Array : C;\n};\n\n},{\"./_is-array\":33,\"./_is-object\":34,\"./_wks\":81}],8:[function(require,module,exports){\n// 9.4.2.3 ArraySpeciesCreate(originalArray, length)\nvar speciesConstructor = require('./_array-species-constructor');\n\nmodule.exports = function (original, length) {\n return new (speciesConstructor(original))(length);\n};\n\n},{\"./_array-species-constructor\":7}],9:[function(require,module,exports){\n// getting tag from 19.1.3.6 Object.prototype.toString()\nvar cof = require('./_cof');\nvar TAG = require('./_wks')('toStringTag');\n// ES3 wrong here\nvar ARG = cof(function () { return arguments; }()) == 'Arguments';\n\n// fallback for IE11 Script Access Denied error\nvar tryGet = function (it, key) {\n try {\n return it[key];\n } catch (e) { /* empty */ }\n};\n\nmodule.exports = function (it) {\n var O, T, B;\n return it === undefined ? 'Undefined' : it === null ? 'Null'\n // @@toStringTag case\n : typeof (T = tryGet(O = Object(it), TAG)) == 'string' ? T\n // builtinTag case\n : ARG ? cof(O)\n // ES3 arguments fallback\n : (B = cof(O)) == 'Object' && typeof O.callee == 'function' ? 'Arguments' : B;\n};\n\n},{\"./_cof\":10,\"./_wks\":81}],10:[function(require,module,exports){\nvar toString = {}.toString;\n\nmodule.exports = function (it) {\n return toString.call(it).slice(8, -1);\n};\n\n},{}],11:[function(require,module,exports){\nvar core = module.exports = { version: '2.6.12' };\nif (typeof __e == 'number') __e = core; // eslint-disable-line no-undef\n\n},{}],12:[function(require,module,exports){\n'use strict';\nvar $defineProperty = require('./_object-dp');\nvar createDesc = require('./_property-desc');\n\nmodule.exports = function (object, index, value) {\n if (index in object) $defineProperty.f(object, index, createDesc(0, value));\n else object[index] = value;\n};\n\n},{\"./_object-dp\":45,\"./_property-desc\":57}],13:[function(require,module,exports){\n// optional / simple context binding\nvar aFunction = require('./_a-function');\nmodule.exports = function (fn, that, length) {\n aFunction(fn);\n if (that === undefined) return fn;\n switch (length) {\n case 1: return function (a) {\n return fn.call(that, a);\n };\n case 2: return function (a, b) {\n return fn.call(that, a, b);\n };\n case 3: return function (a, b, c) {\n return fn.call(that, a, b, c);\n };\n }\n return function (/* ...args */) {\n return fn.apply(that, arguments);\n };\n};\n\n},{\"./_a-function\":1}],14:[function(require,module,exports){\n// 7.2.1 RequireObjectCoercible(argument)\nmodule.exports = function (it) {\n if (it == undefined) throw TypeError(\"Can't call method on \" + it);\n return it;\n};\n\n},{}],15:[function(require,module,exports){\n// Thank's IE8 for his funny defineProperty\nmodule.exports = !require('./_fails')(function () {\n return Object.defineProperty({}, 'a', { get: function () { return 7; } }).a != 7;\n});\n\n},{\"./_fails\":21}],16:[function(require,module,exports){\nvar isObject = require('./_is-object');\nvar document = require('./_global').document;\n// typeof document.createElement is 'object' in old IE\nvar is = isObject(document) && isObject(document.createElement);\nmodule.exports = function (it) {\n return is ? document.createElement(it) : {};\n};\n\n},{\"./_global\":25,\"./_is-object\":34}],17:[function(require,module,exports){\n// IE 8- don't enum bug keys\nmodule.exports = (\n 'constructor,hasOwnProperty,isPrototypeOf,propertyIsEnumerable,toLocaleString,toString,valueOf'\n).split(',');\n\n},{}],18:[function(require,module,exports){\n// all enumerable object keys, includes symbols\nvar getKeys = require('./_object-keys');\nvar gOPS = require('./_object-gops');\nvar pIE = require('./_object-pie');\nmodule.exports = function (it) {\n var result = getKeys(it);\n var getSymbols = gOPS.f;\n if (getSymbols) {\n var symbols = getSymbols(it);\n var isEnum = pIE.f;\n var i = 0;\n var key;\n while (symbols.length > i) if (isEnum.call(it, key = symbols[i++])) result.push(key);\n } return result;\n};\n\n},{\"./_object-gops\":50,\"./_object-keys\":53,\"./_object-pie\":54}],19:[function(require,module,exports){\nvar global = require('./_global');\nvar core = require('./_core');\nvar hide = require('./_hide');\nvar redefine = require('./_redefine');\nvar ctx = require('./_ctx');\nvar PROTOTYPE = 'prototype';\n\nvar $export = function (type, name, source) {\n var IS_FORCED = type & $export.F;\n var IS_GLOBAL = type & $export.G;\n var IS_STATIC = type & $export.S;\n var IS_PROTO = type & $export.P;\n var IS_BIND = type & $export.B;\n var target = IS_GLOBAL ? global : IS_STATIC ? global[name] || (global[name] = {}) : (global[name] || {})[PROTOTYPE];\n var exports = IS_GLOBAL ? core : core[name] || (core[name] = {});\n var expProto = exports[PROTOTYPE] || (exports[PROTOTYPE] = {});\n var key, own, out, exp;\n if (IS_GLOBAL) source = name;\n for (key in source) {\n // contains in native\n own = !IS_FORCED && target && target[key] !== undefined;\n // export native or passed\n out = (own ? target : source)[key];\n // bind timers to global for call from export context\n exp = IS_BIND && own ? ctx(out, global) : IS_PROTO && typeof out == 'function' ? ctx(Function.call, out) : out;\n // extend global\n if (target) redefine(target, key, out, type & $export.U);\n // export\n if (exports[key] != out) hide(exports, key, exp);\n if (IS_PROTO && expProto[key] != out) expProto[key] = out;\n }\n};\nglobal.core = core;\n// type bitmap\n$export.F = 1; // forced\n$export.G = 2; // global\n$export.S = 4; // static\n$export.P = 8; // proto\n$export.B = 16; // bind\n$export.W = 32; // wrap\n$export.U = 64; // safe\n$export.R = 128; // real proto method for `library`\nmodule.exports = $export;\n\n},{\"./_core\":11,\"./_ctx\":13,\"./_global\":25,\"./_hide\":27,\"./_redefine\":58}],20:[function(require,module,exports){\nvar MATCH = require('./_wks')('match');\nmodule.exports = function (KEY) {\n var re = /./;\n try {\n '/./'[KEY](re);\n } catch (e) {\n try {\n re[MATCH] = false;\n return !'/./'[KEY](re);\n } catch (f) { /* empty */ }\n } return true;\n};\n\n},{\"./_wks\":81}],21:[function(require,module,exports){\nmodule.exports = function (exec) {\n try {\n return !!exec();\n } catch (e) {\n return true;\n }\n};\n\n},{}],22:[function(require,module,exports){\n'use strict';\nrequire('./es6.regexp.exec');\nvar redefine = require('./_redefine');\nvar hide = require('./_hide');\nvar fails = require('./_fails');\nvar defined = require('./_defined');\nvar wks = require('./_wks');\nvar regexpExec = require('./_regexp-exec');\n\nvar SPECIES = wks('species');\n\nvar REPLACE_SUPPORTS_NAMED_GROUPS = !fails(function () {\n // #replace needs built-in support for named groups.\n // #match works fine because it just return the exec results, even if it has\n // a \"grops\" property.\n var re = /./;\n re.exec = function () {\n var result = [];\n result.groups = { a: '7' };\n return result;\n };\n return ''.replace(re, '$') !== '7';\n});\n\nvar SPLIT_WORKS_WITH_OVERWRITTEN_EXEC = (function () {\n // Chrome 51 has a buggy \"split\" implementation when RegExp#exec !== nativeExec\n var re = /(?:)/;\n var originalExec = re.exec;\n re.exec = function () { return originalExec.apply(this, arguments); };\n var result = 'ab'.split(re);\n return result.length === 2 && result[0] === 'a' && result[1] === 'b';\n})();\n\nmodule.exports = function (KEY, length, exec) {\n var SYMBOL = wks(KEY);\n\n var DELEGATES_TO_SYMBOL = !fails(function () {\n // String methods call symbol-named RegEp methods\n var O = {};\n O[SYMBOL] = function () { return 7; };\n return ''[KEY](O) != 7;\n });\n\n var DELEGATES_TO_EXEC = DELEGATES_TO_SYMBOL ? !fails(function () {\n // Symbol-named RegExp methods call .exec\n var execCalled = false;\n var re = /a/;\n re.exec = function () { execCalled = true; return null; };\n if (KEY === 'split') {\n // RegExp[@@split] doesn't call the regex's exec method, but first creates\n // a new one. We need to return the patched regex when creating the new one.\n re.constructor = {};\n re.constructor[SPECIES] = function () { return re; };\n }\n re[SYMBOL]('');\n return !execCalled;\n }) : undefined;\n\n if (\n !DELEGATES_TO_SYMBOL ||\n !DELEGATES_TO_EXEC ||\n (KEY === 'replace' && !REPLACE_SUPPORTS_NAMED_GROUPS) ||\n (KEY === 'split' && !SPLIT_WORKS_WITH_OVERWRITTEN_EXEC)\n ) {\n var nativeRegExpMethod = /./[SYMBOL];\n var fns = exec(\n defined,\n SYMBOL,\n ''[KEY],\n function maybeCallNative(nativeMethod, regexp, str, arg2, forceStringMethod) {\n if (regexp.exec === regexpExec) {\n if (DELEGATES_TO_SYMBOL && !forceStringMethod) {\n // The native String method already delegates to @@method (this\n // polyfilled function), leasing to infinite recursion.\n // We avoid it by directly calling the native @@method method.\n return { done: true, value: nativeRegExpMethod.call(regexp, str, arg2) };\n }\n return { done: true, value: nativeMethod.call(str, regexp, arg2) };\n }\n return { done: false };\n }\n );\n var strfn = fns[0];\n var rxfn = fns[1];\n\n redefine(String.prototype, KEY, strfn);\n hide(RegExp.prototype, SYMBOL, length == 2\n // 21.2.5.8 RegExp.prototype[@@replace](string, replaceValue)\n // 21.2.5.11 RegExp.prototype[@@split](string, limit)\n ? function (string, arg) { return rxfn.call(string, this, arg); }\n // 21.2.5.6 RegExp.prototype[@@match](string)\n // 21.2.5.9 RegExp.prototype[@@search](string)\n : function (string) { return rxfn.call(string, this); }\n );\n }\n};\n\n},{\"./_defined\":14,\"./_fails\":21,\"./_hide\":27,\"./_redefine\":58,\"./_regexp-exec\":60,\"./_wks\":81,\"./es6.regexp.exec\":93}],23:[function(require,module,exports){\n'use strict';\n// 21.2.5.3 get RegExp.prototype.flags\nvar anObject = require('./_an-object');\nmodule.exports = function () {\n var that = anObject(this);\n var result = '';\n if (that.global) result += 'g';\n if (that.ignoreCase) result += 'i';\n if (that.multiline) result += 'm';\n if (that.unicode) result += 'u';\n if (that.sticky) result += 'y';\n return result;\n};\n\n},{\"./_an-object\":4}],24:[function(require,module,exports){\nmodule.exports = require('./_shared')('native-function-to-string', Function.toString);\n\n},{\"./_shared\":65}],25:[function(require,module,exports){\n// https://github.com/zloirock/core-js/issues/86#issuecomment-115759028\nvar global = module.exports = typeof window != 'undefined' && window.Math == Math\n ? window : typeof self != 'undefined' && self.Math == Math ? self\n // eslint-disable-next-line no-new-func\n : Function('return this')();\nif (typeof __g == 'number') __g = global; // eslint-disable-line no-undef\n\n},{}],26:[function(require,module,exports){\nvar hasOwnProperty = {}.hasOwnProperty;\nmodule.exports = function (it, key) {\n return hasOwnProperty.call(it, key);\n};\n\n},{}],27:[function(require,module,exports){\nvar dP = require('./_object-dp');\nvar createDesc = require('./_property-desc');\nmodule.exports = require('./_descriptors') ? function (object, key, value) {\n return dP.f(object, key, createDesc(1, value));\n} : function (object, key, value) {\n object[key] = value;\n return object;\n};\n\n},{\"./_descriptors\":15,\"./_object-dp\":45,\"./_property-desc\":57}],28:[function(require,module,exports){\nvar document = require('./_global').document;\nmodule.exports = document && document.documentElement;\n\n},{\"./_global\":25}],29:[function(require,module,exports){\nmodule.exports = !require('./_descriptors') && !require('./_fails')(function () {\n return Object.defineProperty(require('./_dom-create')('div'), 'a', { get: function () { return 7; } }).a != 7;\n});\n\n},{\"./_descriptors\":15,\"./_dom-create\":16,\"./_fails\":21}],30:[function(require,module,exports){\nvar isObject = require('./_is-object');\nvar setPrototypeOf = require('./_set-proto').set;\nmodule.exports = function (that, target, C) {\n var S = target.constructor;\n var P;\n if (S !== C && typeof S == 'function' && (P = S.prototype) !== C.prototype && isObject(P) && setPrototypeOf) {\n setPrototypeOf(that, P);\n } return that;\n};\n\n},{\"./_is-object\":34,\"./_set-proto\":61}],31:[function(require,module,exports){\n// fallback for non-array-like ES3 and non-enumerable old V8 strings\nvar cof = require('./_cof');\n// eslint-disable-next-line no-prototype-builtins\nmodule.exports = Object('z').propertyIsEnumerable(0) ? Object : function (it) {\n return cof(it) == 'String' ? it.split('') : Object(it);\n};\n\n},{\"./_cof\":10}],32:[function(require,module,exports){\n// check on default Array iterator\nvar Iterators = require('./_iterators');\nvar ITERATOR = require('./_wks')('iterator');\nvar ArrayProto = Array.prototype;\n\nmodule.exports = function (it) {\n return it !== undefined && (Iterators.Array === it || ArrayProto[ITERATOR] === it);\n};\n\n},{\"./_iterators\":41,\"./_wks\":81}],33:[function(require,module,exports){\n// 7.2.2 IsArray(argument)\nvar cof = require('./_cof');\nmodule.exports = Array.isArray || function isArray(arg) {\n return cof(arg) == 'Array';\n};\n\n},{\"./_cof\":10}],34:[function(require,module,exports){\nmodule.exports = function (it) {\n return typeof it === 'object' ? it !== null : typeof it === 'function';\n};\n\n},{}],35:[function(require,module,exports){\n// 7.2.8 IsRegExp(argument)\nvar isObject = require('./_is-object');\nvar cof = require('./_cof');\nvar MATCH = require('./_wks')('match');\nmodule.exports = function (it) {\n var isRegExp;\n return isObject(it) && ((isRegExp = it[MATCH]) !== undefined ? !!isRegExp : cof(it) == 'RegExp');\n};\n\n},{\"./_cof\":10,\"./_is-object\":34,\"./_wks\":81}],36:[function(require,module,exports){\n// call something on iterator step with safe closing on error\nvar anObject = require('./_an-object');\nmodule.exports = function (iterator, fn, value, entries) {\n try {\n return entries ? fn(anObject(value)[0], value[1]) : fn(value);\n // 7.4.6 IteratorClose(iterator, completion)\n } catch (e) {\n var ret = iterator['return'];\n if (ret !== undefined) anObject(ret.call(iterator));\n throw e;\n }\n};\n\n},{\"./_an-object\":4}],37:[function(require,module,exports){\n'use strict';\nvar create = require('./_object-create');\nvar descriptor = require('./_property-desc');\nvar setToStringTag = require('./_set-to-string-tag');\nvar IteratorPrototype = {};\n\n// 25.1.2.1.1 %IteratorPrototype%[@@iterator]()\nrequire('./_hide')(IteratorPrototype, require('./_wks')('iterator'), function () { return this; });\n\nmodule.exports = function (Constructor, NAME, next) {\n Constructor.prototype = create(IteratorPrototype, { next: descriptor(1, next) });\n setToStringTag(Constructor, NAME + ' Iterator');\n};\n\n},{\"./_hide\":27,\"./_object-create\":44,\"./_property-desc\":57,\"./_set-to-string-tag\":63,\"./_wks\":81}],38:[function(require,module,exports){\n'use strict';\nvar LIBRARY = require('./_library');\nvar $export = require('./_export');\nvar redefine = require('./_redefine');\nvar hide = require('./_hide');\nvar Iterators = require('./_iterators');\nvar $iterCreate = require('./_iter-create');\nvar setToStringTag = require('./_set-to-string-tag');\nvar getPrototypeOf = require('./_object-gpo');\nvar ITERATOR = require('./_wks')('iterator');\nvar BUGGY = !([].keys && 'next' in [].keys()); // Safari has buggy iterators w/o `next`\nvar FF_ITERATOR = '@@iterator';\nvar KEYS = 'keys';\nvar VALUES = 'values';\n\nvar returnThis = function () { return this; };\n\nmodule.exports = function (Base, NAME, Constructor, next, DEFAULT, IS_SET, FORCED) {\n $iterCreate(Constructor, NAME, next);\n var getMethod = function (kind) {\n if (!BUGGY && kind in proto) return proto[kind];\n switch (kind) {\n case KEYS: return function keys() { return new Constructor(this, kind); };\n case VALUES: return function values() { return new Constructor(this, kind); };\n } return function entries() { return new Constructor(this, kind); };\n };\n var TAG = NAME + ' Iterator';\n var DEF_VALUES = DEFAULT == VALUES;\n var VALUES_BUG = false;\n var proto = Base.prototype;\n var $native = proto[ITERATOR] || proto[FF_ITERATOR] || DEFAULT && proto[DEFAULT];\n var $default = $native || getMethod(DEFAULT);\n var $entries = DEFAULT ? !DEF_VALUES ? $default : getMethod('entries') : undefined;\n var $anyNative = NAME == 'Array' ? proto.entries || $native : $native;\n var methods, key, IteratorPrototype;\n // Fix native\n if ($anyNative) {\n IteratorPrototype = getPrototypeOf($anyNative.call(new Base()));\n if (IteratorPrototype !== Object.prototype && IteratorPrototype.next) {\n // Set @@toStringTag to native iterators\n setToStringTag(IteratorPrototype, TAG, true);\n // fix for some old engines\n if (!LIBRARY && typeof IteratorPrototype[ITERATOR] != 'function') hide(IteratorPrototype, ITERATOR, returnThis);\n }\n }\n // fix Array#{values, @@iterator}.name in V8 / FF\n if (DEF_VALUES && $native && $native.name !== VALUES) {\n VALUES_BUG = true;\n $default = function values() { return $native.call(this); };\n }\n // Define iterator\n if ((!LIBRARY || FORCED) && (BUGGY || VALUES_BUG || !proto[ITERATOR])) {\n hide(proto, ITERATOR, $default);\n }\n // Plug for library\n Iterators[NAME] = $default;\n Iterators[TAG] = returnThis;\n if (DEFAULT) {\n methods = {\n values: DEF_VALUES ? $default : getMethod(VALUES),\n keys: IS_SET ? $default : getMethod(KEYS),\n entries: $entries\n };\n if (FORCED) for (key in methods) {\n if (!(key in proto)) redefine(proto, key, methods[key]);\n } else $export($export.P + $export.F * (BUGGY || VALUES_BUG), NAME, methods);\n }\n return methods;\n};\n\n},{\"./_export\":19,\"./_hide\":27,\"./_iter-create\":37,\"./_iterators\":41,\"./_library\":42,\"./_object-gpo\":51,\"./_redefine\":58,\"./_set-to-string-tag\":63,\"./_wks\":81}],39:[function(require,module,exports){\nvar ITERATOR = require('./_wks')('iterator');\nvar SAFE_CLOSING = false;\n\ntry {\n var riter = [7][ITERATOR]();\n riter['return'] = function () { SAFE_CLOSING = true; };\n // eslint-disable-next-line no-throw-literal\n Array.from(riter, function () { throw 2; });\n} catch (e) { /* empty */ }\n\nmodule.exports = function (exec, skipClosing) {\n if (!skipClosing && !SAFE_CLOSING) return false;\n var safe = false;\n try {\n var arr = [7];\n var iter = arr[ITERATOR]();\n iter.next = function () { return { done: safe = true }; };\n arr[ITERATOR] = function () { return iter; };\n exec(arr);\n } catch (e) { /* empty */ }\n return safe;\n};\n\n},{\"./_wks\":81}],40:[function(require,module,exports){\nmodule.exports = function (done, value) {\n return { value: value, done: !!done };\n};\n\n},{}],41:[function(require,module,exports){\nmodule.exports = {};\n\n},{}],42:[function(require,module,exports){\nmodule.exports = false;\n\n},{}],43:[function(require,module,exports){\nvar META = require('./_uid')('meta');\nvar isObject = require('./_is-object');\nvar has = require('./_has');\nvar setDesc = require('./_object-dp').f;\nvar id = 0;\nvar isExtensible = Object.isExtensible || function () {\n return true;\n};\nvar FREEZE = !require('./_fails')(function () {\n return isExtensible(Object.preventExtensions({}));\n});\nvar setMeta = function (it) {\n setDesc(it, META, { value: {\n i: 'O' + ++id, // object ID\n w: {} // weak collections IDs\n } });\n};\nvar fastKey = function (it, create) {\n // return primitive with prefix\n if (!isObject(it)) return typeof it == 'symbol' ? it : (typeof it == 'string' ? 'S' : 'P') + it;\n if (!has(it, META)) {\n // can't set metadata to uncaught frozen object\n if (!isExtensible(it)) return 'F';\n // not necessary to add metadata\n if (!create) return 'E';\n // add missing metadata\n setMeta(it);\n // return object ID\n } return it[META].i;\n};\nvar getWeak = function (it, create) {\n if (!has(it, META)) {\n // can't set metadata to uncaught frozen object\n if (!isExtensible(it)) return true;\n // not necessary to add metadata\n if (!create) return false;\n // add missing metadata\n setMeta(it);\n // return hash weak collections IDs\n } return it[META].w;\n};\n// add metadata on freeze-family methods calling\nvar onFreeze = function (it) {\n if (FREEZE && meta.NEED && isExtensible(it) && !has(it, META)) setMeta(it);\n return it;\n};\nvar meta = module.exports = {\n KEY: META,\n NEED: false,\n fastKey: fastKey,\n getWeak: getWeak,\n onFreeze: onFreeze\n};\n\n},{\"./_fails\":21,\"./_has\":26,\"./_is-object\":34,\"./_object-dp\":45,\"./_uid\":78}],44:[function(require,module,exports){\n// 19.1.2.2 / 15.2.3.5 Object.create(O [, Properties])\nvar anObject = require('./_an-object');\nvar dPs = require('./_object-dps');\nvar enumBugKeys = require('./_enum-bug-keys');\nvar IE_PROTO = require('./_shared-key')('IE_PROTO');\nvar Empty = function () { /* empty */ };\nvar PROTOTYPE = 'prototype';\n\n// Create object with fake `null` prototype: use iframe Object with cleared prototype\nvar createDict = function () {\n // Thrash, waste and sodomy: IE GC bug\n var iframe = require('./_dom-create')('iframe');\n var i = enumBugKeys.length;\n var lt = '<';\n var gt = '>';\n var iframeDocument;\n iframe.style.display = 'none';\n require('./_html').appendChild(iframe);\n iframe.src = 'javascript:'; // eslint-disable-line no-script-url\n // createDict = iframe.contentWindow.Object;\n // html.removeChild(iframe);\n iframeDocument = iframe.contentWindow.document;\n iframeDocument.open();\n iframeDocument.write(lt + 'script' + gt + 'document.F=Object' + lt + '/script' + gt);\n iframeDocument.close();\n createDict = iframeDocument.F;\n while (i--) delete createDict[PROTOTYPE][enumBugKeys[i]];\n return createDict();\n};\n\nmodule.exports = Object.create || function create(O, Properties) {\n var result;\n if (O !== null) {\n Empty[PROTOTYPE] = anObject(O);\n result = new Empty();\n Empty[PROTOTYPE] = null;\n // add \"__proto__\" for Object.getPrototypeOf polyfill\n result[IE_PROTO] = O;\n } else result = createDict();\n return Properties === undefined ? result : dPs(result, Properties);\n};\n\n},{\"./_an-object\":4,\"./_dom-create\":16,\"./_enum-bug-keys\":17,\"./_html\":28,\"./_object-dps\":46,\"./_shared-key\":64}],45:[function(require,module,exports){\nvar anObject = require('./_an-object');\nvar IE8_DOM_DEFINE = require('./_ie8-dom-define');\nvar toPrimitive = require('./_to-primitive');\nvar dP = Object.defineProperty;\n\nexports.f = require('./_descriptors') ? Object.defineProperty : function defineProperty(O, P, Attributes) {\n anObject(O);\n P = toPrimitive(P, true);\n anObject(Attributes);\n if (IE8_DOM_DEFINE) try {\n return dP(O, P, Attributes);\n } catch (e) { /* empty */ }\n if ('get' in Attributes || 'set' in Attributes) throw TypeError('Accessors not supported!');\n if ('value' in Attributes) O[P] = Attributes.value;\n return O;\n};\n\n},{\"./_an-object\":4,\"./_descriptors\":15,\"./_ie8-dom-define\":29,\"./_to-primitive\":77}],46:[function(require,module,exports){\nvar dP = require('./_object-dp');\nvar anObject = require('./_an-object');\nvar getKeys = require('./_object-keys');\n\nmodule.exports = require('./_descriptors') ? Object.defineProperties : function defineProperties(O, Properties) {\n anObject(O);\n var keys = getKeys(Properties);\n var length = keys.length;\n var i = 0;\n var P;\n while (length > i) dP.f(O, P = keys[i++], Properties[P]);\n return O;\n};\n\n},{\"./_an-object\":4,\"./_descriptors\":15,\"./_object-dp\":45,\"./_object-keys\":53}],47:[function(require,module,exports){\nvar pIE = require('./_object-pie');\nvar createDesc = require('./_property-desc');\nvar toIObject = require('./_to-iobject');\nvar toPrimitive = require('./_to-primitive');\nvar has = require('./_has');\nvar IE8_DOM_DEFINE = require('./_ie8-dom-define');\nvar gOPD = Object.getOwnPropertyDescriptor;\n\nexports.f = require('./_descriptors') ? gOPD : function getOwnPropertyDescriptor(O, P) {\n O = toIObject(O);\n P = toPrimitive(P, true);\n if (IE8_DOM_DEFINE) try {\n return gOPD(O, P);\n } catch (e) { /* empty */ }\n if (has(O, P)) return createDesc(!pIE.f.call(O, P), O[P]);\n};\n\n},{\"./_descriptors\":15,\"./_has\":26,\"./_ie8-dom-define\":29,\"./_object-pie\":54,\"./_property-desc\":57,\"./_to-iobject\":74,\"./_to-primitive\":77}],48:[function(require,module,exports){\n// fallback for IE11 buggy Object.getOwnPropertyNames with iframe and window\nvar toIObject = require('./_to-iobject');\nvar gOPN = require('./_object-gopn').f;\nvar toString = {}.toString;\n\nvar windowNames = typeof window == 'object' && window && Object.getOwnPropertyNames\n ? Object.getOwnPropertyNames(window) : [];\n\nvar getWindowNames = function (it) {\n try {\n return gOPN(it);\n } catch (e) {\n return windowNames.slice();\n }\n};\n\nmodule.exports.f = function getOwnPropertyNames(it) {\n return windowNames && toString.call(it) == '[object Window]' ? getWindowNames(it) : gOPN(toIObject(it));\n};\n\n},{\"./_object-gopn\":49,\"./_to-iobject\":74}],49:[function(require,module,exports){\n// 19.1.2.7 / 15.2.3.4 Object.getOwnPropertyNames(O)\nvar $keys = require('./_object-keys-internal');\nvar hiddenKeys = require('./_enum-bug-keys').concat('length', 'prototype');\n\nexports.f = Object.getOwnPropertyNames || function getOwnPropertyNames(O) {\n return $keys(O, hiddenKeys);\n};\n\n},{\"./_enum-bug-keys\":17,\"./_object-keys-internal\":52}],50:[function(require,module,exports){\nexports.f = Object.getOwnPropertySymbols;\n\n},{}],51:[function(require,module,exports){\n// 19.1.2.9 / 15.2.3.2 Object.getPrototypeOf(O)\nvar has = require('./_has');\nvar toObject = require('./_to-object');\nvar IE_PROTO = require('./_shared-key')('IE_PROTO');\nvar ObjectProto = Object.prototype;\n\nmodule.exports = Object.getPrototypeOf || function (O) {\n O = toObject(O);\n if (has(O, IE_PROTO)) return O[IE_PROTO];\n if (typeof O.constructor == 'function' && O instanceof O.constructor) {\n return O.constructor.prototype;\n } return O instanceof Object ? ObjectProto : null;\n};\n\n},{\"./_has\":26,\"./_shared-key\":64,\"./_to-object\":76}],52:[function(require,module,exports){\nvar has = require('./_has');\nvar toIObject = require('./_to-iobject');\nvar arrayIndexOf = require('./_array-includes')(false);\nvar IE_PROTO = require('./_shared-key')('IE_PROTO');\n\nmodule.exports = function (object, names) {\n var O = toIObject(object);\n var i = 0;\n var result = [];\n var key;\n for (key in O) if (key != IE_PROTO) has(O, key) && result.push(key);\n // Don't enum bug & hidden keys\n while (names.length > i) if (has(O, key = names[i++])) {\n ~arrayIndexOf(result, key) || result.push(key);\n }\n return result;\n};\n\n},{\"./_array-includes\":5,\"./_has\":26,\"./_shared-key\":64,\"./_to-iobject\":74}],53:[function(require,module,exports){\n// 19.1.2.14 / 15.2.3.14 Object.keys(O)\nvar $keys = require('./_object-keys-internal');\nvar enumBugKeys = require('./_enum-bug-keys');\n\nmodule.exports = Object.keys || function keys(O) {\n return $keys(O, enumBugKeys);\n};\n\n},{\"./_enum-bug-keys\":17,\"./_object-keys-internal\":52}],54:[function(require,module,exports){\nexports.f = {}.propertyIsEnumerable;\n\n},{}],55:[function(require,module,exports){\n// most Object methods by ES6 should accept primitives\nvar $export = require('./_export');\nvar core = require('./_core');\nvar fails = require('./_fails');\nmodule.exports = function (KEY, exec) {\n var fn = (core.Object || {})[KEY] || Object[KEY];\n var exp = {};\n exp[KEY] = exec(fn);\n $export($export.S + $export.F * fails(function () { fn(1); }), 'Object', exp);\n};\n\n},{\"./_core\":11,\"./_export\":19,\"./_fails\":21}],56:[function(require,module,exports){\n// all object keys, includes non-enumerable and symbols\nvar gOPN = require('./_object-gopn');\nvar gOPS = require('./_object-gops');\nvar anObject = require('./_an-object');\nvar Reflect = require('./_global').Reflect;\nmodule.exports = Reflect && Reflect.ownKeys || function ownKeys(it) {\n var keys = gOPN.f(anObject(it));\n var getSymbols = gOPS.f;\n return getSymbols ? keys.concat(getSymbols(it)) : keys;\n};\n\n},{\"./_an-object\":4,\"./_global\":25,\"./_object-gopn\":49,\"./_object-gops\":50}],57:[function(require,module,exports){\nmodule.exports = function (bitmap, value) {\n return {\n enumerable: !(bitmap & 1),\n configurable: !(bitmap & 2),\n writable: !(bitmap & 4),\n value: value\n };\n};\n\n},{}],58:[function(require,module,exports){\nvar global = require('./_global');\nvar hide = require('./_hide');\nvar has = require('./_has');\nvar SRC = require('./_uid')('src');\nvar $toString = require('./_function-to-string');\nvar TO_STRING = 'toString';\nvar TPL = ('' + $toString).split(TO_STRING);\n\nrequire('./_core').inspectSource = function (it) {\n return $toString.call(it);\n};\n\n(module.exports = function (O, key, val, safe) {\n var isFunction = typeof val == 'function';\n if (isFunction) has(val, 'name') || hide(val, 'name', key);\n if (O[key] === val) return;\n if (isFunction) has(val, SRC) || hide(val, SRC, O[key] ? '' + O[key] : TPL.join(String(key)));\n if (O === global) {\n O[key] = val;\n } else if (!safe) {\n delete O[key];\n hide(O, key, val);\n } else if (O[key]) {\n O[key] = val;\n } else {\n hide(O, key, val);\n }\n// add fake Function#toString for correct work wrapped methods / constructors with methods like LoDash isNative\n})(Function.prototype, TO_STRING, function toString() {\n return typeof this == 'function' && this[SRC] || $toString.call(this);\n});\n\n},{\"./_core\":11,\"./_function-to-string\":24,\"./_global\":25,\"./_has\":26,\"./_hide\":27,\"./_uid\":78}],59:[function(require,module,exports){\n'use strict';\n\nvar classof = require('./_classof');\nvar builtinExec = RegExp.prototype.exec;\n\n // `RegExpExec` abstract operation\n// https://tc39.github.io/ecma262/#sec-regexpexec\nmodule.exports = function (R, S) {\n var exec = R.exec;\n if (typeof exec === 'function') {\n var result = exec.call(R, S);\n if (typeof result !== 'object') {\n throw new TypeError('RegExp exec method returned something other than an Object or null');\n }\n return result;\n }\n if (classof(R) !== 'RegExp') {\n throw new TypeError('RegExp#exec called on incompatible receiver');\n }\n return builtinExec.call(R, S);\n};\n\n},{\"./_classof\":9}],60:[function(require,module,exports){\n'use strict';\n\nvar regexpFlags = require('./_flags');\n\nvar nativeExec = RegExp.prototype.exec;\n// This always refers to the native implementation, because the\n// String#replace polyfill uses ./fix-regexp-well-known-symbol-logic.js,\n// which loads this file before patching the method.\nvar nativeReplace = String.prototype.replace;\n\nvar patchedExec = nativeExec;\n\nvar LAST_INDEX = 'lastIndex';\n\nvar UPDATES_LAST_INDEX_WRONG = (function () {\n var re1 = /a/,\n re2 = /b*/g;\n nativeExec.call(re1, 'a');\n nativeExec.call(re2, 'a');\n return re1[LAST_INDEX] !== 0 || re2[LAST_INDEX] !== 0;\n})();\n\n// nonparticipating capturing group, copied from es5-shim's String#split patch.\nvar NPCG_INCLUDED = /()??/.exec('')[1] !== undefined;\n\nvar PATCH = UPDATES_LAST_INDEX_WRONG || NPCG_INCLUDED;\n\nif (PATCH) {\n patchedExec = function exec(str) {\n var re = this;\n var lastIndex, reCopy, match, i;\n\n if (NPCG_INCLUDED) {\n reCopy = new RegExp('^' + re.source + '$(?!\\\\s)', regexpFlags.call(re));\n }\n if (UPDATES_LAST_INDEX_WRONG) lastIndex = re[LAST_INDEX];\n\n match = nativeExec.call(re, str);\n\n if (UPDATES_LAST_INDEX_WRONG && match) {\n re[LAST_INDEX] = re.global ? match.index + match[0].length : lastIndex;\n }\n if (NPCG_INCLUDED && match && match.length > 1) {\n // Fix browsers whose `exec` methods don't consistently return `undefined`\n // for NPCG, like IE8. NOTE: This doesn' work for /(.?)?/\n // eslint-disable-next-line no-loop-func\n nativeReplace.call(match[0], reCopy, function () {\n for (i = 1; i < arguments.length - 2; i++) {\n if (arguments[i] === undefined) match[i] = undefined;\n }\n });\n }\n\n return match;\n };\n}\n\nmodule.exports = patchedExec;\n\n},{\"./_flags\":23}],61:[function(require,module,exports){\n// Works with __proto__ only. Old v8 can't work with null proto objects.\n/* eslint-disable no-proto */\nvar isObject = require('./_is-object');\nvar anObject = require('./_an-object');\nvar check = function (O, proto) {\n anObject(O);\n if (!isObject(proto) && proto !== null) throw TypeError(proto + \": can't set as prototype!\");\n};\nmodule.exports = {\n set: Object.setPrototypeOf || ('__proto__' in {} ? // eslint-disable-line\n function (test, buggy, set) {\n try {\n set = require('./_ctx')(Function.call, require('./_object-gopd').f(Object.prototype, '__proto__').set, 2);\n set(test, []);\n buggy = !(test instanceof Array);\n } catch (e) { buggy = true; }\n return function setPrototypeOf(O, proto) {\n check(O, proto);\n if (buggy) O.__proto__ = proto;\n else set(O, proto);\n return O;\n };\n }({}, false) : undefined),\n check: check\n};\n\n},{\"./_an-object\":4,\"./_ctx\":13,\"./_is-object\":34,\"./_object-gopd\":47}],62:[function(require,module,exports){\n'use strict';\nvar global = require('./_global');\nvar dP = require('./_object-dp');\nvar DESCRIPTORS = require('./_descriptors');\nvar SPECIES = require('./_wks')('species');\n\nmodule.exports = function (KEY) {\n var C = global[KEY];\n if (DESCRIPTORS && C && !C[SPECIES]) dP.f(C, SPECIES, {\n configurable: true,\n get: function () { return this; }\n });\n};\n\n},{\"./_descriptors\":15,\"./_global\":25,\"./_object-dp\":45,\"./_wks\":81}],63:[function(require,module,exports){\nvar def = require('./_object-dp').f;\nvar has = require('./_has');\nvar TAG = require('./_wks')('toStringTag');\n\nmodule.exports = function (it, tag, stat) {\n if (it && !has(it = stat ? it : it.prototype, TAG)) def(it, TAG, { configurable: true, value: tag });\n};\n\n},{\"./_has\":26,\"./_object-dp\":45,\"./_wks\":81}],64:[function(require,module,exports){\nvar shared = require('./_shared')('keys');\nvar uid = require('./_uid');\nmodule.exports = function (key) {\n return shared[key] || (shared[key] = uid(key));\n};\n\n},{\"./_shared\":65,\"./_uid\":78}],65:[function(require,module,exports){\nvar core = require('./_core');\nvar global = require('./_global');\nvar SHARED = '__core-js_shared__';\nvar store = global[SHARED] || (global[SHARED] = {});\n\n(module.exports = function (key, value) {\n return store[key] || (store[key] = value !== undefined ? value : {});\n})('versions', []).push({\n version: core.version,\n mode: require('./_library') ? 'pure' : 'global',\n copyright: '© 2020 Denis Pushkarev (zloirock.ru)'\n});\n\n},{\"./_core\":11,\"./_global\":25,\"./_library\":42}],66:[function(require,module,exports){\n// 7.3.20 SpeciesConstructor(O, defaultConstructor)\nvar anObject = require('./_an-object');\nvar aFunction = require('./_a-function');\nvar SPECIES = require('./_wks')('species');\nmodule.exports = function (O, D) {\n var C = anObject(O).constructor;\n var S;\n return C === undefined || (S = anObject(C)[SPECIES]) == undefined ? D : aFunction(S);\n};\n\n},{\"./_a-function\":1,\"./_an-object\":4,\"./_wks\":81}],67:[function(require,module,exports){\n'use strict';\nvar fails = require('./_fails');\n\nmodule.exports = function (method, arg) {\n return !!method && fails(function () {\n // eslint-disable-next-line no-useless-call\n arg ? method.call(null, function () { /* empty */ }, 1) : method.call(null);\n });\n};\n\n},{\"./_fails\":21}],68:[function(require,module,exports){\nvar toInteger = require('./_to-integer');\nvar defined = require('./_defined');\n// true -> String#at\n// false -> String#codePointAt\nmodule.exports = function (TO_STRING) {\n return function (that, pos) {\n var s = String(defined(that));\n var i = toInteger(pos);\n var l = s.length;\n var a, b;\n if (i < 0 || i >= l) return TO_STRING ? '' : undefined;\n a = s.charCodeAt(i);\n return a < 0xd800 || a > 0xdbff || i + 1 === l || (b = s.charCodeAt(i + 1)) < 0xdc00 || b > 0xdfff\n ? TO_STRING ? s.charAt(i) : a\n : TO_STRING ? s.slice(i, i + 2) : (a - 0xd800 << 10) + (b - 0xdc00) + 0x10000;\n };\n};\n\n},{\"./_defined\":14,\"./_to-integer\":73}],69:[function(require,module,exports){\n// helper for String#{startsWith, endsWith, includes}\nvar isRegExp = require('./_is-regexp');\nvar defined = require('./_defined');\n\nmodule.exports = function (that, searchString, NAME) {\n if (isRegExp(searchString)) throw TypeError('String#' + NAME + \" doesn't accept regex!\");\n return String(defined(that));\n};\n\n},{\"./_defined\":14,\"./_is-regexp\":35}],70:[function(require,module,exports){\nvar $export = require('./_export');\nvar defined = require('./_defined');\nvar fails = require('./_fails');\nvar spaces = require('./_string-ws');\nvar space = '[' + spaces + ']';\nvar non = '\\u200b\\u0085';\nvar ltrim = RegExp('^' + space + space + '*');\nvar rtrim = RegExp(space + space + '*$');\n\nvar exporter = function (KEY, exec, ALIAS) {\n var exp = {};\n var FORCE = fails(function () {\n return !!spaces[KEY]() || non[KEY]() != non;\n });\n var fn = exp[KEY] = FORCE ? exec(trim) : spaces[KEY];\n if (ALIAS) exp[ALIAS] = fn;\n $export($export.P + $export.F * FORCE, 'String', exp);\n};\n\n// 1 -> String#trimLeft\n// 2 -> String#trimRight\n// 3 -> String#trim\nvar trim = exporter.trim = function (string, TYPE) {\n string = String(defined(string));\n if (TYPE & 1) string = string.replace(ltrim, '');\n if (TYPE & 2) string = string.replace(rtrim, '');\n return string;\n};\n\nmodule.exports = exporter;\n\n},{\"./_defined\":14,\"./_export\":19,\"./_fails\":21,\"./_string-ws\":71}],71:[function(require,module,exports){\nmodule.exports = '\\x09\\x0A\\x0B\\x0C\\x0D\\x20\\xA0\\u1680\\u180E\\u2000\\u2001\\u2002\\u2003' +\n '\\u2004\\u2005\\u2006\\u2007\\u2008\\u2009\\u200A\\u202F\\u205F\\u3000\\u2028\\u2029\\uFEFF';\n\n},{}],72:[function(require,module,exports){\nvar toInteger = require('./_to-integer');\nvar max = Math.max;\nvar min = Math.min;\nmodule.exports = function (index, length) {\n index = toInteger(index);\n return index < 0 ? max(index + length, 0) : min(index, length);\n};\n\n},{\"./_to-integer\":73}],73:[function(require,module,exports){\n// 7.1.4 ToInteger\nvar ceil = Math.ceil;\nvar floor = Math.floor;\nmodule.exports = function (it) {\n return isNaN(it = +it) ? 0 : (it > 0 ? floor : ceil)(it);\n};\n\n},{}],74:[function(require,module,exports){\n// to indexed object, toObject with fallback for non-array-like ES3 strings\nvar IObject = require('./_iobject');\nvar defined = require('./_defined');\nmodule.exports = function (it) {\n return IObject(defined(it));\n};\n\n},{\"./_defined\":14,\"./_iobject\":31}],75:[function(require,module,exports){\n// 7.1.15 ToLength\nvar toInteger = require('./_to-integer');\nvar min = Math.min;\nmodule.exports = function (it) {\n return it > 0 ? min(toInteger(it), 0x1fffffffffffff) : 0; // pow(2, 53) - 1 == 9007199254740991\n};\n\n},{\"./_to-integer\":73}],76:[function(require,module,exports){\n// 7.1.13 ToObject(argument)\nvar defined = require('./_defined');\nmodule.exports = function (it) {\n return Object(defined(it));\n};\n\n},{\"./_defined\":14}],77:[function(require,module,exports){\n// 7.1.1 ToPrimitive(input [, PreferredType])\nvar isObject = require('./_is-object');\n// instead of the ES6 spec version, we didn't implement @@toPrimitive case\n// and the second argument - flag - preferred type is a string\nmodule.exports = function (it, S) {\n if (!isObject(it)) return it;\n var fn, val;\n if (S && typeof (fn = it.toString) == 'function' && !isObject(val = fn.call(it))) return val;\n if (typeof (fn = it.valueOf) == 'function' && !isObject(val = fn.call(it))) return val;\n if (!S && typeof (fn = it.toString) == 'function' && !isObject(val = fn.call(it))) return val;\n throw TypeError(\"Can't convert object to primitive value\");\n};\n\n},{\"./_is-object\":34}],78:[function(require,module,exports){\nvar id = 0;\nvar px = Math.random();\nmodule.exports = function (key) {\n return 'Symbol('.concat(key === undefined ? '' : key, ')_', (++id + px).toString(36));\n};\n\n},{}],79:[function(require,module,exports){\nvar global = require('./_global');\nvar core = require('./_core');\nvar LIBRARY = require('./_library');\nvar wksExt = require('./_wks-ext');\nvar defineProperty = require('./_object-dp').f;\nmodule.exports = function (name) {\n var $Symbol = core.Symbol || (core.Symbol = LIBRARY ? {} : global.Symbol || {});\n if (name.charAt(0) != '_' && !(name in $Symbol)) defineProperty($Symbol, name, { value: wksExt.f(name) });\n};\n\n},{\"./_core\":11,\"./_global\":25,\"./_library\":42,\"./_object-dp\":45,\"./_wks-ext\":80}],80:[function(require,module,exports){\nexports.f = require('./_wks');\n\n},{\"./_wks\":81}],81:[function(require,module,exports){\nvar store = require('./_shared')('wks');\nvar uid = require('./_uid');\nvar Symbol = require('./_global').Symbol;\nvar USE_SYMBOL = typeof Symbol == 'function';\n\nvar $exports = module.exports = function (name) {\n return store[name] || (store[name] =\n USE_SYMBOL && Symbol[name] || (USE_SYMBOL ? Symbol : uid)('Symbol.' + name));\n};\n\n$exports.store = store;\n\n},{\"./_global\":25,\"./_shared\":65,\"./_uid\":78}],82:[function(require,module,exports){\nvar classof = require('./_classof');\nvar ITERATOR = require('./_wks')('iterator');\nvar Iterators = require('./_iterators');\nmodule.exports = require('./_core').getIteratorMethod = function (it) {\n if (it != undefined) return it[ITERATOR]\n || it['@@iterator']\n || Iterators[classof(it)];\n};\n\n},{\"./_classof\":9,\"./_core\":11,\"./_iterators\":41,\"./_wks\":81}],83:[function(require,module,exports){\n'use strict';\nvar $export = require('./_export');\nvar $filter = require('./_array-methods')(2);\n\n$export($export.P + $export.F * !require('./_strict-method')([].filter, true), 'Array', {\n // 22.1.3.7 / 15.4.4.20 Array.prototype.filter(callbackfn [, thisArg])\n filter: function filter(callbackfn /* , thisArg */) {\n return $filter(this, callbackfn, arguments[1]);\n }\n});\n\n},{\"./_array-methods\":6,\"./_export\":19,\"./_strict-method\":67}],84:[function(require,module,exports){\n'use strict';\nvar ctx = require('./_ctx');\nvar $export = require('./_export');\nvar toObject = require('./_to-object');\nvar call = require('./_iter-call');\nvar isArrayIter = require('./_is-array-iter');\nvar toLength = require('./_to-length');\nvar createProperty = require('./_create-property');\nvar getIterFn = require('./core.get-iterator-method');\n\n$export($export.S + $export.F * !require('./_iter-detect')(function (iter) { Array.from(iter); }), 'Array', {\n // 22.1.2.1 Array.from(arrayLike, mapfn = undefined, thisArg = undefined)\n from: function from(arrayLike /* , mapfn = undefined, thisArg = undefined */) {\n var O = toObject(arrayLike);\n var C = typeof this == 'function' ? this : Array;\n var aLen = arguments.length;\n var mapfn = aLen > 1 ? arguments[1] : undefined;\n var mapping = mapfn !== undefined;\n var index = 0;\n var iterFn = getIterFn(O);\n var length, result, step, iterator;\n if (mapping) mapfn = ctx(mapfn, aLen > 2 ? arguments[2] : undefined, 2);\n // if object isn't iterable or it's array with default iterator - use simple case\n if (iterFn != undefined && !(C == Array && isArrayIter(iterFn))) {\n for (iterator = iterFn.call(O), result = new C(); !(step = iterator.next()).done; index++) {\n createProperty(result, index, mapping ? call(iterator, mapfn, [step.value, index], true) : step.value);\n }\n } else {\n length = toLength(O.length);\n for (result = new C(length); length > index; index++) {\n createProperty(result, index, mapping ? mapfn(O[index], index) : O[index]);\n }\n }\n result.length = index;\n return result;\n }\n});\n\n},{\"./_create-property\":12,\"./_ctx\":13,\"./_export\":19,\"./_is-array-iter\":32,\"./_iter-call\":36,\"./_iter-detect\":39,\"./_to-length\":75,\"./_to-object\":76,\"./core.get-iterator-method\":82}],85:[function(require,module,exports){\n'use strict';\nvar addToUnscopables = require('./_add-to-unscopables');\nvar step = require('./_iter-step');\nvar Iterators = require('./_iterators');\nvar toIObject = require('./_to-iobject');\n\n// 22.1.3.4 Array.prototype.entries()\n// 22.1.3.13 Array.prototype.keys()\n// 22.1.3.29 Array.prototype.values()\n// 22.1.3.30 Array.prototype[@@iterator]()\nmodule.exports = require('./_iter-define')(Array, 'Array', function (iterated, kind) {\n this._t = toIObject(iterated); // target\n this._i = 0; // next index\n this._k = kind; // kind\n// 22.1.5.2.1 %ArrayIteratorPrototype%.next()\n}, function () {\n var O = this._t;\n var kind = this._k;\n var index = this._i++;\n if (!O || index >= O.length) {\n this._t = undefined;\n return step(1);\n }\n if (kind == 'keys') return step(0, index);\n if (kind == 'values') return step(0, O[index]);\n return step(0, [index, O[index]]);\n}, 'values');\n\n// argumentsList[@@iterator] is %ArrayProto_values% (9.4.4.6, 9.4.4.7)\nIterators.Arguments = Iterators.Array;\n\naddToUnscopables('keys');\naddToUnscopables('values');\naddToUnscopables('entries');\n\n},{\"./_add-to-unscopables\":2,\"./_iter-define\":38,\"./_iter-step\":40,\"./_iterators\":41,\"./_to-iobject\":74}],86:[function(require,module,exports){\n'use strict';\nvar $export = require('./_export');\nvar $map = require('./_array-methods')(1);\n\n$export($export.P + $export.F * !require('./_strict-method')([].map, true), 'Array', {\n // 22.1.3.15 / 15.4.4.19 Array.prototype.map(callbackfn [, thisArg])\n map: function map(callbackfn /* , thisArg */) {\n return $map(this, callbackfn, arguments[1]);\n }\n});\n\n},{\"./_array-methods\":6,\"./_export\":19,\"./_strict-method\":67}],87:[function(require,module,exports){\n'use strict';\nvar $export = require('./_export');\nvar html = require('./_html');\nvar cof = require('./_cof');\nvar toAbsoluteIndex = require('./_to-absolute-index');\nvar toLength = require('./_to-length');\nvar arraySlice = [].slice;\n\n// fallback for not array-like ES3 strings and DOM objects\n$export($export.P + $export.F * require('./_fails')(function () {\n if (html) arraySlice.call(html);\n}), 'Array', {\n slice: function slice(begin, end) {\n var len = toLength(this.length);\n var klass = cof(this);\n end = end === undefined ? len : end;\n if (klass == 'Array') return arraySlice.call(this, begin, end);\n var start = toAbsoluteIndex(begin, len);\n var upTo = toAbsoluteIndex(end, len);\n var size = toLength(upTo - start);\n var cloned = new Array(size);\n var i = 0;\n for (; i < size; i++) cloned[i] = klass == 'String'\n ? this.charAt(start + i)\n : this[start + i];\n return cloned;\n }\n});\n\n},{\"./_cof\":10,\"./_export\":19,\"./_fails\":21,\"./_html\":28,\"./_to-absolute-index\":72,\"./_to-length\":75}],88:[function(require,module,exports){\n'use strict';\nvar global = require('./_global');\nvar has = require('./_has');\nvar cof = require('./_cof');\nvar inheritIfRequired = require('./_inherit-if-required');\nvar toPrimitive = require('./_to-primitive');\nvar fails = require('./_fails');\nvar gOPN = require('./_object-gopn').f;\nvar gOPD = require('./_object-gopd').f;\nvar dP = require('./_object-dp').f;\nvar $trim = require('./_string-trim').trim;\nvar NUMBER = 'Number';\nvar $Number = global[NUMBER];\nvar Base = $Number;\nvar proto = $Number.prototype;\n// Opera ~12 has broken Object#toString\nvar BROKEN_COF = cof(require('./_object-create')(proto)) == NUMBER;\nvar TRIM = 'trim' in String.prototype;\n\n// 7.1.3 ToNumber(argument)\nvar toNumber = function (argument) {\n var it = toPrimitive(argument, false);\n if (typeof it == 'string' && it.length > 2) {\n it = TRIM ? it.trim() : $trim(it, 3);\n var first = it.charCodeAt(0);\n var third, radix, maxCode;\n if (first === 43 || first === 45) {\n third = it.charCodeAt(2);\n if (third === 88 || third === 120) return NaN; // Number('+0x1') should be NaN, old V8 fix\n } else if (first === 48) {\n switch (it.charCodeAt(1)) {\n case 66: case 98: radix = 2; maxCode = 49; break; // fast equal /^0b[01]+$/i\n case 79: case 111: radix = 8; maxCode = 55; break; // fast equal /^0o[0-7]+$/i\n default: return +it;\n }\n for (var digits = it.slice(2), i = 0, l = digits.length, code; i < l; i++) {\n code = digits.charCodeAt(i);\n // parseInt parses a string to a first unavailable symbol\n // but ToNumber should return NaN if a string contains unavailable symbols\n if (code < 48 || code > maxCode) return NaN;\n } return parseInt(digits, radix);\n }\n } return +it;\n};\n\nif (!$Number(' 0o1') || !$Number('0b1') || $Number('+0x1')) {\n $Number = function Number(value) {\n var it = arguments.length < 1 ? 0 : value;\n var that = this;\n return that instanceof $Number\n // check on 1..constructor(foo) case\n && (BROKEN_COF ? fails(function () { proto.valueOf.call(that); }) : cof(that) != NUMBER)\n ? inheritIfRequired(new Base(toNumber(it)), that, $Number) : toNumber(it);\n };\n for (var keys = require('./_descriptors') ? gOPN(Base) : (\n // ES3:\n 'MAX_VALUE,MIN_VALUE,NaN,NEGATIVE_INFINITY,POSITIVE_INFINITY,' +\n // ES6 (in case, if modules with ES6 Number statics required before):\n 'EPSILON,isFinite,isInteger,isNaN,isSafeInteger,MAX_SAFE_INTEGER,' +\n 'MIN_SAFE_INTEGER,parseFloat,parseInt,isInteger'\n ).split(','), j = 0, key; keys.length > j; j++) {\n if (has(Base, key = keys[j]) && !has($Number, key)) {\n dP($Number, key, gOPD(Base, key));\n }\n }\n $Number.prototype = proto;\n proto.constructor = $Number;\n require('./_redefine')(global, NUMBER, $Number);\n}\n\n},{\"./_cof\":10,\"./_descriptors\":15,\"./_fails\":21,\"./_global\":25,\"./_has\":26,\"./_inherit-if-required\":30,\"./_object-create\":44,\"./_object-dp\":45,\"./_object-gopd\":47,\"./_object-gopn\":49,\"./_redefine\":58,\"./_string-trim\":70,\"./_to-primitive\":77}],89:[function(require,module,exports){\n// 19.1.2.6 Object.getOwnPropertyDescriptor(O, P)\nvar toIObject = require('./_to-iobject');\nvar $getOwnPropertyDescriptor = require('./_object-gopd').f;\n\nrequire('./_object-sap')('getOwnPropertyDescriptor', function () {\n return function getOwnPropertyDescriptor(it, key) {\n return $getOwnPropertyDescriptor(toIObject(it), key);\n };\n});\n\n},{\"./_object-gopd\":47,\"./_object-sap\":55,\"./_to-iobject\":74}],90:[function(require,module,exports){\n// 19.1.2.14 Object.keys(O)\nvar toObject = require('./_to-object');\nvar $keys = require('./_object-keys');\n\nrequire('./_object-sap')('keys', function () {\n return function keys(it) {\n return $keys(toObject(it));\n };\n});\n\n},{\"./_object-keys\":53,\"./_object-sap\":55,\"./_to-object\":76}],91:[function(require,module,exports){\n'use strict';\n// 19.1.3.6 Object.prototype.toString()\nvar classof = require('./_classof');\nvar test = {};\ntest[require('./_wks')('toStringTag')] = 'z';\nif (test + '' != '[object z]') {\n require('./_redefine')(Object.prototype, 'toString', function toString() {\n return '[object ' + classof(this) + ']';\n }, true);\n}\n\n},{\"./_classof\":9,\"./_redefine\":58,\"./_wks\":81}],92:[function(require,module,exports){\nvar global = require('./_global');\nvar inheritIfRequired = require('./_inherit-if-required');\nvar dP = require('./_object-dp').f;\nvar gOPN = require('./_object-gopn').f;\nvar isRegExp = require('./_is-regexp');\nvar $flags = require('./_flags');\nvar $RegExp = global.RegExp;\nvar Base = $RegExp;\nvar proto = $RegExp.prototype;\nvar re1 = /a/g;\nvar re2 = /a/g;\n// \"new\" creates a new object, old webkit buggy here\nvar CORRECT_NEW = new $RegExp(re1) !== re1;\n\nif (require('./_descriptors') && (!CORRECT_NEW || require('./_fails')(function () {\n re2[require('./_wks')('match')] = false;\n // RegExp constructor can alter flags and IsRegExp works correct with @@match\n return $RegExp(re1) != re1 || $RegExp(re2) == re2 || $RegExp(re1, 'i') != '/a/i';\n}))) {\n $RegExp = function RegExp(p, f) {\n var tiRE = this instanceof $RegExp;\n var piRE = isRegExp(p);\n var fiU = f === undefined;\n return !tiRE && piRE && p.constructor === $RegExp && fiU ? p\n : inheritIfRequired(CORRECT_NEW\n ? new Base(piRE && !fiU ? p.source : p, f)\n : Base((piRE = p instanceof $RegExp) ? p.source : p, piRE && fiU ? $flags.call(p) : f)\n , tiRE ? this : proto, $RegExp);\n };\n var proxy = function (key) {\n key in $RegExp || dP($RegExp, key, {\n configurable: true,\n get: function () { return Base[key]; },\n set: function (it) { Base[key] = it; }\n });\n };\n for (var keys = gOPN(Base), i = 0; keys.length > i;) proxy(keys[i++]);\n proto.constructor = $RegExp;\n $RegExp.prototype = proto;\n require('./_redefine')(global, 'RegExp', $RegExp);\n}\n\nrequire('./_set-species')('RegExp');\n\n},{\"./_descriptors\":15,\"./_fails\":21,\"./_flags\":23,\"./_global\":25,\"./_inherit-if-required\":30,\"./_is-regexp\":35,\"./_object-dp\":45,\"./_object-gopn\":49,\"./_redefine\":58,\"./_set-species\":62,\"./_wks\":81}],93:[function(require,module,exports){\n'use strict';\nvar regexpExec = require('./_regexp-exec');\nrequire('./_export')({\n target: 'RegExp',\n proto: true,\n forced: regexpExec !== /./.exec\n}, {\n exec: regexpExec\n});\n\n},{\"./_export\":19,\"./_regexp-exec\":60}],94:[function(require,module,exports){\n'use strict';\n\nvar anObject = require('./_an-object');\nvar toLength = require('./_to-length');\nvar advanceStringIndex = require('./_advance-string-index');\nvar regExpExec = require('./_regexp-exec-abstract');\n\n// @@match logic\nrequire('./_fix-re-wks')('match', 1, function (defined, MATCH, $match, maybeCallNative) {\n return [\n // `String.prototype.match` method\n // https://tc39.github.io/ecma262/#sec-string.prototype.match\n function match(regexp) {\n var O = defined(this);\n var fn = regexp == undefined ? undefined : regexp[MATCH];\n return fn !== undefined ? fn.call(regexp, O) : new RegExp(regexp)[MATCH](String(O));\n },\n // `RegExp.prototype[@@match]` method\n // https://tc39.github.io/ecma262/#sec-regexp.prototype-@@match\n function (regexp) {\n var res = maybeCallNative($match, regexp, this);\n if (res.done) return res.value;\n var rx = anObject(regexp);\n var S = String(this);\n if (!rx.global) return regExpExec(rx, S);\n var fullUnicode = rx.unicode;\n rx.lastIndex = 0;\n var A = [];\n var n = 0;\n var result;\n while ((result = regExpExec(rx, S)) !== null) {\n var matchStr = String(result[0]);\n A[n] = matchStr;\n if (matchStr === '') rx.lastIndex = advanceStringIndex(S, toLength(rx.lastIndex), fullUnicode);\n n++;\n }\n return n === 0 ? null : A;\n }\n ];\n});\n\n},{\"./_advance-string-index\":3,\"./_an-object\":4,\"./_fix-re-wks\":22,\"./_regexp-exec-abstract\":59,\"./_to-length\":75}],95:[function(require,module,exports){\n'use strict';\n\nvar anObject = require('./_an-object');\nvar toObject = require('./_to-object');\nvar toLength = require('./_to-length');\nvar toInteger = require('./_to-integer');\nvar advanceStringIndex = require('./_advance-string-index');\nvar regExpExec = require('./_regexp-exec-abstract');\nvar max = Math.max;\nvar min = Math.min;\nvar floor = Math.floor;\nvar SUBSTITUTION_SYMBOLS = /\\$([$&`']|\\d\\d?|<[^>]*>)/g;\nvar SUBSTITUTION_SYMBOLS_NO_NAMED = /\\$([$&`']|\\d\\d?)/g;\n\nvar maybeToString = function (it) {\n return it === undefined ? it : String(it);\n};\n\n// @@replace logic\nrequire('./_fix-re-wks')('replace', 2, function (defined, REPLACE, $replace, maybeCallNative) {\n return [\n // `String.prototype.replace` method\n // https://tc39.github.io/ecma262/#sec-string.prototype.replace\n function replace(searchValue, replaceValue) {\n var O = defined(this);\n var fn = searchValue == undefined ? undefined : searchValue[REPLACE];\n return fn !== undefined\n ? fn.call(searchValue, O, replaceValue)\n : $replace.call(String(O), searchValue, replaceValue);\n },\n // `RegExp.prototype[@@replace]` method\n // https://tc39.github.io/ecma262/#sec-regexp.prototype-@@replace\n function (regexp, replaceValue) {\n var res = maybeCallNative($replace, regexp, this, replaceValue);\n if (res.done) return res.value;\n\n var rx = anObject(regexp);\n var S = String(this);\n var functionalReplace = typeof replaceValue === 'function';\n if (!functionalReplace) replaceValue = String(replaceValue);\n var global = rx.global;\n if (global) {\n var fullUnicode = rx.unicode;\n rx.lastIndex = 0;\n }\n var results = [];\n while (true) {\n var result = regExpExec(rx, S);\n if (result === null) break;\n results.push(result);\n if (!global) break;\n var matchStr = String(result[0]);\n if (matchStr === '') rx.lastIndex = advanceStringIndex(S, toLength(rx.lastIndex), fullUnicode);\n }\n var accumulatedResult = '';\n var nextSourcePosition = 0;\n for (var i = 0; i < results.length; i++) {\n result = results[i];\n var matched = String(result[0]);\n var position = max(min(toInteger(result.index), S.length), 0);\n var captures = [];\n // NOTE: This is equivalent to\n // captures = result.slice(1).map(maybeToString)\n // but for some reason `nativeSlice.call(result, 1, result.length)` (called in\n // the slice polyfill when slicing native arrays) \"doesn't work\" in safari 9 and\n // causes a crash (https://pastebin.com/N21QzeQA) when trying to debug it.\n for (var j = 1; j < result.length; j++) captures.push(maybeToString(result[j]));\n var namedCaptures = result.groups;\n if (functionalReplace) {\n var replacerArgs = [matched].concat(captures, position, S);\n if (namedCaptures !== undefined) replacerArgs.push(namedCaptures);\n var replacement = String(replaceValue.apply(undefined, replacerArgs));\n } else {\n replacement = getSubstitution(matched, S, position, captures, namedCaptures, replaceValue);\n }\n if (position >= nextSourcePosition) {\n accumulatedResult += S.slice(nextSourcePosition, position) + replacement;\n nextSourcePosition = position + matched.length;\n }\n }\n return accumulatedResult + S.slice(nextSourcePosition);\n }\n ];\n\n // https://tc39.github.io/ecma262/#sec-getsubstitution\n function getSubstitution(matched, str, position, captures, namedCaptures, replacement) {\n var tailPos = position + matched.length;\n var m = captures.length;\n var symbols = SUBSTITUTION_SYMBOLS_NO_NAMED;\n if (namedCaptures !== undefined) {\n namedCaptures = toObject(namedCaptures);\n symbols = SUBSTITUTION_SYMBOLS;\n }\n return $replace.call(replacement, symbols, function (match, ch) {\n var capture;\n switch (ch.charAt(0)) {\n case '$': return '$';\n case '&': return matched;\n case '`': return str.slice(0, position);\n case \"'\": return str.slice(tailPos);\n case '<':\n capture = namedCaptures[ch.slice(1, -1)];\n break;\n default: // \\d\\d?\n var n = +ch;\n if (n === 0) return match;\n if (n > m) {\n var f = floor(n / 10);\n if (f === 0) return match;\n if (f <= m) return captures[f - 1] === undefined ? ch.charAt(1) : captures[f - 1] + ch.charAt(1);\n return match;\n }\n capture = captures[n - 1];\n }\n return capture === undefined ? '' : capture;\n });\n }\n});\n\n},{\"./_advance-string-index\":3,\"./_an-object\":4,\"./_fix-re-wks\":22,\"./_regexp-exec-abstract\":59,\"./_to-integer\":73,\"./_to-length\":75,\"./_to-object\":76}],96:[function(require,module,exports){\n'use strict';\n\nvar isRegExp = require('./_is-regexp');\nvar anObject = require('./_an-object');\nvar speciesConstructor = require('./_species-constructor');\nvar advanceStringIndex = require('./_advance-string-index');\nvar toLength = require('./_to-length');\nvar callRegExpExec = require('./_regexp-exec-abstract');\nvar regexpExec = require('./_regexp-exec');\nvar fails = require('./_fails');\nvar $min = Math.min;\nvar $push = [].push;\nvar $SPLIT = 'split';\nvar LENGTH = 'length';\nvar LAST_INDEX = 'lastIndex';\nvar MAX_UINT32 = 0xffffffff;\n\n// babel-minify transpiles RegExp('x', 'y') -> /x/y and it causes SyntaxError\nvar SUPPORTS_Y = !fails(function () { RegExp(MAX_UINT32, 'y'); });\n\n// @@split logic\nrequire('./_fix-re-wks')('split', 2, function (defined, SPLIT, $split, maybeCallNative) {\n var internalSplit;\n if (\n 'abbc'[$SPLIT](/(b)*/)[1] == 'c' ||\n 'test'[$SPLIT](/(?:)/, -1)[LENGTH] != 4 ||\n 'ab'[$SPLIT](/(?:ab)*/)[LENGTH] != 2 ||\n '.'[$SPLIT](/(.?)(.?)/)[LENGTH] != 4 ||\n '.'[$SPLIT](/()()/)[LENGTH] > 1 ||\n ''[$SPLIT](/.?/)[LENGTH]\n ) {\n // based on es5-shim implementation, need to rework it\n internalSplit = function (separator, limit) {\n var string = String(this);\n if (separator === undefined && limit === 0) return [];\n // If `separator` is not a regex, use native split\n if (!isRegExp(separator)) return $split.call(string, separator, limit);\n var output = [];\n var flags = (separator.ignoreCase ? 'i' : '') +\n (separator.multiline ? 'm' : '') +\n (separator.unicode ? 'u' : '') +\n (separator.sticky ? 'y' : '');\n var lastLastIndex = 0;\n var splitLimit = limit === undefined ? MAX_UINT32 : limit >>> 0;\n // Make `global` and avoid `lastIndex` issues by working with a copy\n var separatorCopy = new RegExp(separator.source, flags + 'g');\n var match, lastIndex, lastLength;\n while (match = regexpExec.call(separatorCopy, string)) {\n lastIndex = separatorCopy[LAST_INDEX];\n if (lastIndex > lastLastIndex) {\n output.push(string.slice(lastLastIndex, match.index));\n if (match[LENGTH] > 1 && match.index < string[LENGTH]) $push.apply(output, match.slice(1));\n lastLength = match[0][LENGTH];\n lastLastIndex = lastIndex;\n if (output[LENGTH] >= splitLimit) break;\n }\n if (separatorCopy[LAST_INDEX] === match.index) separatorCopy[LAST_INDEX]++; // Avoid an infinite loop\n }\n if (lastLastIndex === string[LENGTH]) {\n if (lastLength || !separatorCopy.test('')) output.push('');\n } else output.push(string.slice(lastLastIndex));\n return output[LENGTH] > splitLimit ? output.slice(0, splitLimit) : output;\n };\n // Chakra, V8\n } else if ('0'[$SPLIT](undefined, 0)[LENGTH]) {\n internalSplit = function (separator, limit) {\n return separator === undefined && limit === 0 ? [] : $split.call(this, separator, limit);\n };\n } else {\n internalSplit = $split;\n }\n\n return [\n // `String.prototype.split` method\n // https://tc39.github.io/ecma262/#sec-string.prototype.split\n function split(separator, limit) {\n var O = defined(this);\n var splitter = separator == undefined ? undefined : separator[SPLIT];\n return splitter !== undefined\n ? splitter.call(separator, O, limit)\n : internalSplit.call(String(O), separator, limit);\n },\n // `RegExp.prototype[@@split]` method\n // https://tc39.github.io/ecma262/#sec-regexp.prototype-@@split\n //\n // NOTE: This cannot be properly polyfilled in engines that don't support\n // the 'y' flag.\n function (regexp, limit) {\n var res = maybeCallNative(internalSplit, regexp, this, limit, internalSplit !== $split);\n if (res.done) return res.value;\n\n var rx = anObject(regexp);\n var S = String(this);\n var C = speciesConstructor(rx, RegExp);\n\n var unicodeMatching = rx.unicode;\n var flags = (rx.ignoreCase ? 'i' : '') +\n (rx.multiline ? 'm' : '') +\n (rx.unicode ? 'u' : '') +\n (SUPPORTS_Y ? 'y' : 'g');\n\n // ^(? + rx + ) is needed, in combination with some S slicing, to\n // simulate the 'y' flag.\n var splitter = new C(SUPPORTS_Y ? rx : '^(?:' + rx.source + ')', flags);\n var lim = limit === undefined ? MAX_UINT32 : limit >>> 0;\n if (lim === 0) return [];\n if (S.length === 0) return callRegExpExec(splitter, S) === null ? [S] : [];\n var p = 0;\n var q = 0;\n var A = [];\n while (q < S.length) {\n splitter.lastIndex = SUPPORTS_Y ? q : 0;\n var z = callRegExpExec(splitter, SUPPORTS_Y ? S : S.slice(q));\n var e;\n if (\n z === null ||\n (e = $min(toLength(splitter.lastIndex + (SUPPORTS_Y ? 0 : q)), S.length)) === p\n ) {\n q = advanceStringIndex(S, q, unicodeMatching);\n } else {\n A.push(S.slice(p, q));\n if (A.length === lim) return A;\n for (var i = 1; i <= z.length - 1; i++) {\n A.push(z[i]);\n if (A.length === lim) return A;\n }\n q = p = e;\n }\n }\n A.push(S.slice(p));\n return A;\n }\n ];\n});\n\n},{\"./_advance-string-index\":3,\"./_an-object\":4,\"./_fails\":21,\"./_fix-re-wks\":22,\"./_is-regexp\":35,\"./_regexp-exec\":60,\"./_regexp-exec-abstract\":59,\"./_species-constructor\":66,\"./_to-length\":75}],97:[function(require,module,exports){\n// 21.1.3.7 String.prototype.includes(searchString, position = 0)\n'use strict';\nvar $export = require('./_export');\nvar context = require('./_string-context');\nvar INCLUDES = 'includes';\n\n$export($export.P + $export.F * require('./_fails-is-regexp')(INCLUDES), 'String', {\n includes: function includes(searchString /* , position = 0 */) {\n return !!~context(this, searchString, INCLUDES)\n .indexOf(searchString, arguments.length > 1 ? arguments[1] : undefined);\n }\n});\n\n},{\"./_export\":19,\"./_fails-is-regexp\":20,\"./_string-context\":69}],98:[function(require,module,exports){\n'use strict';\nvar $at = require('./_string-at')(true);\n\n// 21.1.3.27 String.prototype[@@iterator]()\nrequire('./_iter-define')(String, 'String', function (iterated) {\n this._t = String(iterated); // target\n this._i = 0; // next index\n// 21.1.5.2.1 %StringIteratorPrototype%.next()\n}, function () {\n var O = this._t;\n var index = this._i;\n var point;\n if (index >= O.length) return { value: undefined, done: true };\n point = $at(O, index);\n this._i += point.length;\n return { value: point, done: false };\n});\n\n},{\"./_iter-define\":38,\"./_string-at\":68}],99:[function(require,module,exports){\n'use strict';\n// ECMAScript 6 symbols shim\nvar global = require('./_global');\nvar has = require('./_has');\nvar DESCRIPTORS = require('./_descriptors');\nvar $export = require('./_export');\nvar redefine = require('./_redefine');\nvar META = require('./_meta').KEY;\nvar $fails = require('./_fails');\nvar shared = require('./_shared');\nvar setToStringTag = require('./_set-to-string-tag');\nvar uid = require('./_uid');\nvar wks = require('./_wks');\nvar wksExt = require('./_wks-ext');\nvar wksDefine = require('./_wks-define');\nvar enumKeys = require('./_enum-keys');\nvar isArray = require('./_is-array');\nvar anObject = require('./_an-object');\nvar isObject = require('./_is-object');\nvar toObject = require('./_to-object');\nvar toIObject = require('./_to-iobject');\nvar toPrimitive = require('./_to-primitive');\nvar createDesc = require('./_property-desc');\nvar _create = require('./_object-create');\nvar gOPNExt = require('./_object-gopn-ext');\nvar $GOPD = require('./_object-gopd');\nvar $GOPS = require('./_object-gops');\nvar $DP = require('./_object-dp');\nvar $keys = require('./_object-keys');\nvar gOPD = $GOPD.f;\nvar dP = $DP.f;\nvar gOPN = gOPNExt.f;\nvar $Symbol = global.Symbol;\nvar $JSON = global.JSON;\nvar _stringify = $JSON && $JSON.stringify;\nvar PROTOTYPE = 'prototype';\nvar HIDDEN = wks('_hidden');\nvar TO_PRIMITIVE = wks('toPrimitive');\nvar isEnum = {}.propertyIsEnumerable;\nvar SymbolRegistry = shared('symbol-registry');\nvar AllSymbols = shared('symbols');\nvar OPSymbols = shared('op-symbols');\nvar ObjectProto = Object[PROTOTYPE];\nvar USE_NATIVE = typeof $Symbol == 'function' && !!$GOPS.f;\nvar QObject = global.QObject;\n// Don't use setters in Qt Script, https://github.com/zloirock/core-js/issues/173\nvar setter = !QObject || !QObject[PROTOTYPE] || !QObject[PROTOTYPE].findChild;\n\n// fallback for old Android, https://code.google.com/p/v8/issues/detail?id=687\nvar setSymbolDesc = DESCRIPTORS && $fails(function () {\n return _create(dP({}, 'a', {\n get: function () { return dP(this, 'a', { value: 7 }).a; }\n })).a != 7;\n}) ? function (it, key, D) {\n var protoDesc = gOPD(ObjectProto, key);\n if (protoDesc) delete ObjectProto[key];\n dP(it, key, D);\n if (protoDesc && it !== ObjectProto) dP(ObjectProto, key, protoDesc);\n} : dP;\n\nvar wrap = function (tag) {\n var sym = AllSymbols[tag] = _create($Symbol[PROTOTYPE]);\n sym._k = tag;\n return sym;\n};\n\nvar isSymbol = USE_NATIVE && typeof $Symbol.iterator == 'symbol' ? function (it) {\n return typeof it == 'symbol';\n} : function (it) {\n return it instanceof $Symbol;\n};\n\nvar $defineProperty = function defineProperty(it, key, D) {\n if (it === ObjectProto) $defineProperty(OPSymbols, key, D);\n anObject(it);\n key = toPrimitive(key, true);\n anObject(D);\n if (has(AllSymbols, key)) {\n if (!D.enumerable) {\n if (!has(it, HIDDEN)) dP(it, HIDDEN, createDesc(1, {}));\n it[HIDDEN][key] = true;\n } else {\n if (has(it, HIDDEN) && it[HIDDEN][key]) it[HIDDEN][key] = false;\n D = _create(D, { enumerable: createDesc(0, false) });\n } return setSymbolDesc(it, key, D);\n } return dP(it, key, D);\n};\nvar $defineProperties = function defineProperties(it, P) {\n anObject(it);\n var keys = enumKeys(P = toIObject(P));\n var i = 0;\n var l = keys.length;\n var key;\n while (l > i) $defineProperty(it, key = keys[i++], P[key]);\n return it;\n};\nvar $create = function create(it, P) {\n return P === undefined ? _create(it) : $defineProperties(_create(it), P);\n};\nvar $propertyIsEnumerable = function propertyIsEnumerable(key) {\n var E = isEnum.call(this, key = toPrimitive(key, true));\n if (this === ObjectProto && has(AllSymbols, key) && !has(OPSymbols, key)) return false;\n return E || !has(this, key) || !has(AllSymbols, key) || has(this, HIDDEN) && this[HIDDEN][key] ? E : true;\n};\nvar $getOwnPropertyDescriptor = function getOwnPropertyDescriptor(it, key) {\n it = toIObject(it);\n key = toPrimitive(key, true);\n if (it === ObjectProto && has(AllSymbols, key) && !has(OPSymbols, key)) return;\n var D = gOPD(it, key);\n if (D && has(AllSymbols, key) && !(has(it, HIDDEN) && it[HIDDEN][key])) D.enumerable = true;\n return D;\n};\nvar $getOwnPropertyNames = function getOwnPropertyNames(it) {\n var names = gOPN(toIObject(it));\n var result = [];\n var i = 0;\n var key;\n while (names.length > i) {\n if (!has(AllSymbols, key = names[i++]) && key != HIDDEN && key != META) result.push(key);\n } return result;\n};\nvar $getOwnPropertySymbols = function getOwnPropertySymbols(it) {\n var IS_OP = it === ObjectProto;\n var names = gOPN(IS_OP ? OPSymbols : toIObject(it));\n var result = [];\n var i = 0;\n var key;\n while (names.length > i) {\n if (has(AllSymbols, key = names[i++]) && (IS_OP ? has(ObjectProto, key) : true)) result.push(AllSymbols[key]);\n } return result;\n};\n\n// 19.4.1.1 Symbol([description])\nif (!USE_NATIVE) {\n $Symbol = function Symbol() {\n if (this instanceof $Symbol) throw TypeError('Symbol is not a constructor!');\n var tag = uid(arguments.length > 0 ? arguments[0] : undefined);\n var $set = function (value) {\n if (this === ObjectProto) $set.call(OPSymbols, value);\n if (has(this, HIDDEN) && has(this[HIDDEN], tag)) this[HIDDEN][tag] = false;\n setSymbolDesc(this, tag, createDesc(1, value));\n };\n if (DESCRIPTORS && setter) setSymbolDesc(ObjectProto, tag, { configurable: true, set: $set });\n return wrap(tag);\n };\n redefine($Symbol[PROTOTYPE], 'toString', function toString() {\n return this._k;\n });\n\n $GOPD.f = $getOwnPropertyDescriptor;\n $DP.f = $defineProperty;\n require('./_object-gopn').f = gOPNExt.f = $getOwnPropertyNames;\n require('./_object-pie').f = $propertyIsEnumerable;\n $GOPS.f = $getOwnPropertySymbols;\n\n if (DESCRIPTORS && !require('./_library')) {\n redefine(ObjectProto, 'propertyIsEnumerable', $propertyIsEnumerable, true);\n }\n\n wksExt.f = function (name) {\n return wrap(wks(name));\n };\n}\n\n$export($export.G + $export.W + $export.F * !USE_NATIVE, { Symbol: $Symbol });\n\nfor (var es6Symbols = (\n // 19.4.2.2, 19.4.2.3, 19.4.2.4, 19.4.2.6, 19.4.2.8, 19.4.2.9, 19.4.2.10, 19.4.2.11, 19.4.2.12, 19.4.2.13, 19.4.2.14\n 'hasInstance,isConcatSpreadable,iterator,match,replace,search,species,split,toPrimitive,toStringTag,unscopables'\n).split(','), j = 0; es6Symbols.length > j;)wks(es6Symbols[j++]);\n\nfor (var wellKnownSymbols = $keys(wks.store), k = 0; wellKnownSymbols.length > k;) wksDefine(wellKnownSymbols[k++]);\n\n$export($export.S + $export.F * !USE_NATIVE, 'Symbol', {\n // 19.4.2.1 Symbol.for(key)\n 'for': function (key) {\n return has(SymbolRegistry, key += '')\n ? SymbolRegistry[key]\n : SymbolRegistry[key] = $Symbol(key);\n },\n // 19.4.2.5 Symbol.keyFor(sym)\n keyFor: function keyFor(sym) {\n if (!isSymbol(sym)) throw TypeError(sym + ' is not a symbol!');\n for (var key in SymbolRegistry) if (SymbolRegistry[key] === sym) return key;\n },\n useSetter: function () { setter = true; },\n useSimple: function () { setter = false; }\n});\n\n$export($export.S + $export.F * !USE_NATIVE, 'Object', {\n // 19.1.2.2 Object.create(O [, Properties])\n create: $create,\n // 19.1.2.4 Object.defineProperty(O, P, Attributes)\n defineProperty: $defineProperty,\n // 19.1.2.3 Object.defineProperties(O, Properties)\n defineProperties: $defineProperties,\n // 19.1.2.6 Object.getOwnPropertyDescriptor(O, P)\n getOwnPropertyDescriptor: $getOwnPropertyDescriptor,\n // 19.1.2.7 Object.getOwnPropertyNames(O)\n getOwnPropertyNames: $getOwnPropertyNames,\n // 19.1.2.8 Object.getOwnPropertySymbols(O)\n getOwnPropertySymbols: $getOwnPropertySymbols\n});\n\n// Chrome 38 and 39 `Object.getOwnPropertySymbols` fails on primitives\n// https://bugs.chromium.org/p/v8/issues/detail?id=3443\nvar FAILS_ON_PRIMITIVES = $fails(function () { $GOPS.f(1); });\n\n$export($export.S + $export.F * FAILS_ON_PRIMITIVES, 'Object', {\n getOwnPropertySymbols: function getOwnPropertySymbols(it) {\n return $GOPS.f(toObject(it));\n }\n});\n\n// 24.3.2 JSON.stringify(value [, replacer [, space]])\n$JSON && $export($export.S + $export.F * (!USE_NATIVE || $fails(function () {\n var S = $Symbol();\n // MS Edge converts symbol values to JSON as {}\n // WebKit converts symbol values to JSON as null\n // V8 throws on boxed symbols\n return _stringify([S]) != '[null]' || _stringify({ a: S }) != '{}' || _stringify(Object(S)) != '{}';\n})), 'JSON', {\n stringify: function stringify(it) {\n var args = [it];\n var i = 1;\n var replacer, $replacer;\n while (arguments.length > i) args.push(arguments[i++]);\n $replacer = replacer = args[1];\n if (!isObject(replacer) && it === undefined || isSymbol(it)) return; // IE8 returns string on undefined\n if (!isArray(replacer)) replacer = function (key, value) {\n if (typeof $replacer == 'function') value = $replacer.call(this, key, value);\n if (!isSymbol(value)) return value;\n };\n args[1] = replacer;\n return _stringify.apply($JSON, args);\n }\n});\n\n// 19.4.3.4 Symbol.prototype[@@toPrimitive](hint)\n$Symbol[PROTOTYPE][TO_PRIMITIVE] || require('./_hide')($Symbol[PROTOTYPE], TO_PRIMITIVE, $Symbol[PROTOTYPE].valueOf);\n// 19.4.3.5 Symbol.prototype[@@toStringTag]\nsetToStringTag($Symbol, 'Symbol');\n// 20.2.1.9 Math[@@toStringTag]\nsetToStringTag(Math, 'Math', true);\n// 24.3.3 JSON[@@toStringTag]\nsetToStringTag(global.JSON, 'JSON', true);\n\n},{\"./_an-object\":4,\"./_descriptors\":15,\"./_enum-keys\":18,\"./_export\":19,\"./_fails\":21,\"./_global\":25,\"./_has\":26,\"./_hide\":27,\"./_is-array\":33,\"./_is-object\":34,\"./_library\":42,\"./_meta\":43,\"./_object-create\":44,\"./_object-dp\":45,\"./_object-gopd\":47,\"./_object-gopn\":49,\"./_object-gopn-ext\":48,\"./_object-gops\":50,\"./_object-keys\":53,\"./_object-pie\":54,\"./_property-desc\":57,\"./_redefine\":58,\"./_set-to-string-tag\":63,\"./_shared\":65,\"./_to-iobject\":74,\"./_to-object\":76,\"./_to-primitive\":77,\"./_uid\":78,\"./_wks\":81,\"./_wks-define\":79,\"./_wks-ext\":80}],100:[function(require,module,exports){\n'use strict';\n// https://github.com/tc39/Array.prototype.includes\nvar $export = require('./_export');\nvar $includes = require('./_array-includes')(true);\n\n$export($export.P, 'Array', {\n includes: function includes(el /* , fromIndex = 0 */) {\n return $includes(this, el, arguments.length > 1 ? arguments[1] : undefined);\n }\n});\n\nrequire('./_add-to-unscopables')('includes');\n\n},{\"./_add-to-unscopables\":2,\"./_array-includes\":5,\"./_export\":19}],101:[function(require,module,exports){\n// https://github.com/tc39/proposal-object-getownpropertydescriptors\nvar $export = require('./_export');\nvar ownKeys = require('./_own-keys');\nvar toIObject = require('./_to-iobject');\nvar gOPD = require('./_object-gopd');\nvar createProperty = require('./_create-property');\n\n$export($export.S, 'Object', {\n getOwnPropertyDescriptors: function getOwnPropertyDescriptors(object) {\n var O = toIObject(object);\n var getDesc = gOPD.f;\n var keys = ownKeys(O);\n var result = {};\n var i = 0;\n var key, desc;\n while (keys.length > i) {\n desc = getDesc(O, key = keys[i++]);\n if (desc !== undefined) createProperty(result, key, desc);\n }\n return result;\n }\n});\n\n},{\"./_create-property\":12,\"./_export\":19,\"./_object-gopd\":47,\"./_own-keys\":56,\"./_to-iobject\":74}],102:[function(require,module,exports){\nvar $iterators = require('./es6.array.iterator');\nvar getKeys = require('./_object-keys');\nvar redefine = require('./_redefine');\nvar global = require('./_global');\nvar hide = require('./_hide');\nvar Iterators = require('./_iterators');\nvar wks = require('./_wks');\nvar ITERATOR = wks('iterator');\nvar TO_STRING_TAG = wks('toStringTag');\nvar ArrayValues = Iterators.Array;\n\nvar DOMIterables = {\n CSSRuleList: true, // TODO: Not spec compliant, should be false.\n CSSStyleDeclaration: false,\n CSSValueList: false,\n ClientRectList: false,\n DOMRectList: false,\n DOMStringList: false,\n DOMTokenList: true,\n DataTransferItemList: false,\n FileList: false,\n HTMLAllCollection: false,\n HTMLCollection: false,\n HTMLFormElement: false,\n HTMLSelectElement: false,\n MediaList: true, // TODO: Not spec compliant, should be false.\n MimeTypeArray: false,\n NamedNodeMap: false,\n NodeList: true,\n PaintRequestList: false,\n Plugin: false,\n PluginArray: false,\n SVGLengthList: false,\n SVGNumberList: false,\n SVGPathSegList: false,\n SVGPointList: false,\n SVGStringList: false,\n SVGTransformList: false,\n SourceBufferList: false,\n StyleSheetList: true, // TODO: Not spec compliant, should be false.\n TextTrackCueList: false,\n TextTrackList: false,\n TouchList: false\n};\n\nfor (var collections = getKeys(DOMIterables), i = 0; i < collections.length; i++) {\n var NAME = collections[i];\n var explicit = DOMIterables[NAME];\n var Collection = global[NAME];\n var proto = Collection && Collection.prototype;\n var key;\n if (proto) {\n if (!proto[ITERATOR]) hide(proto, ITERATOR, ArrayValues);\n if (!proto[TO_STRING_TAG]) hide(proto, TO_STRING_TAG, NAME);\n Iterators[NAME] = ArrayValues;\n if (explicit) for (key in $iterators) if (!proto[key]) redefine(proto, key, $iterators[key], true);\n }\n}\n\n},{\"./_global\":25,\"./_hide\":27,\"./_iterators\":41,\"./_object-keys\":53,\"./_redefine\":58,\"./_wks\":81,\"./es6.array.iterator\":85}],103:[function(require,module,exports){\n\"use strict\";\n\nrequire(\"core-js/modules/es6.symbol.js\");\nrequire(\"core-js/modules/es6.number.constructor.js\");\nrequire(\"core-js/modules/es6.string.iterator.js\");\nrequire(\"core-js/modules/es6.object.to-string.js\");\nrequire(\"core-js/modules/es6.array.iterator.js\");\nrequire(\"core-js/modules/web.dom.iterable.js\");\nfunction _typeof(obj) { \"@babel/helpers - typeof\"; return _typeof = \"function\" == typeof Symbol && \"symbol\" == typeof Symbol.iterator ? function (obj) { return typeof obj; } : function (obj) { return obj && \"function\" == typeof Symbol && obj.constructor === Symbol && obj !== Symbol.prototype ? \"symbol\" : typeof obj; }, _typeof(obj); }\nfunction _classCallCheck(instance, Constructor) { if (!(instance instanceof Constructor)) { throw new TypeError(\"Cannot call a class as a function\"); } }\nfunction _defineProperties(target, props) { for (var i = 0; i < props.length; i++) { var descriptor = props[i]; descriptor.enumerable = descriptor.enumerable || false; descriptor.configurable = true; if (\"value\" in descriptor) descriptor.writable = true; Object.defineProperty(target, _toPropertyKey(descriptor.key), descriptor); } }\nfunction _createClass(Constructor, protoProps, staticProps) { if (protoProps) _defineProperties(Constructor.prototype, protoProps); if (staticProps) _defineProperties(Constructor, staticProps); Object.defineProperty(Constructor, \"prototype\", { writable: false }); return Constructor; }\nfunction _toPropertyKey(arg) { var key = _toPrimitive(arg, \"string\"); return _typeof(key) === \"symbol\" ? key : String(key); }\nfunction _toPrimitive(input, hint) { if (_typeof(input) !== \"object\" || input === null) return input; var prim = input[Symbol.toPrimitive]; if (prim !== undefined) { var res = prim.call(input, hint || \"default\"); if (_typeof(res) !== \"object\") return res; throw new TypeError(\"@@toPrimitive must return a primitive value.\"); } return (hint === \"string\" ? String : Number)(input); }\nvar _require = require('./protocol'),\n Parser = _require.Parser,\n PROTOCOL_6 = _require.PROTOCOL_6,\n PROTOCOL_7 = _require.PROTOCOL_7;\nvar VERSION = \"4.0.1\";\nvar Connector = /*#__PURE__*/function () {\n function Connector(options, WebSocket, Timer, handlers) {\n var _this = this;\n _classCallCheck(this, Connector);\n this.options = options;\n this.WebSocket = WebSocket;\n this.Timer = Timer;\n this.handlers = handlers;\n var path = this.options.path ? \"\".concat(this.options.path) : 'livereload';\n var port = this.options.port ? \":\".concat(this.options.port) : '';\n this._uri = \"ws\".concat(this.options.https ? 's' : '', \"://\").concat(this.options.host).concat(port, \"/\").concat(path);\n this._nextDelay = this.options.mindelay;\n this._connectionDesired = false;\n this.protocol = 0;\n this.protocolParser = new Parser({\n connected: function connected(protocol) {\n _this.protocol = protocol;\n _this._handshakeTimeout.stop();\n _this._nextDelay = _this.options.mindelay;\n _this._disconnectionReason = 'broken';\n return _this.handlers.connected(_this.protocol);\n },\n error: function error(e) {\n _this.handlers.error(e);\n return _this._closeOnError();\n },\n message: function message(_message) {\n return _this.handlers.message(_message);\n }\n });\n this._handshakeTimeout = new this.Timer(function () {\n if (!_this._isSocketConnected()) {\n return;\n }\n _this._disconnectionReason = 'handshake-timeout';\n return _this.socket.close();\n });\n this._reconnectTimer = new this.Timer(function () {\n if (!_this._connectionDesired) {\n // shouldn't hit this, but just in case\n return;\n }\n return _this.connect();\n });\n this.connect();\n }\n _createClass(Connector, [{\n key: \"_isSocketConnected\",\n value: function _isSocketConnected() {\n return this.socket && this.socket.readyState === this.WebSocket.OPEN;\n }\n }, {\n key: \"connect\",\n value: function connect() {\n var _this2 = this;\n this._connectionDesired = true;\n if (this._isSocketConnected()) {\n return;\n }\n\n // prepare for a new connection\n this._reconnectTimer.stop();\n this._disconnectionReason = 'cannot-connect';\n this.protocolParser.reset();\n this.handlers.connecting();\n this.socket = new this.WebSocket(this._uri);\n this.socket.onopen = function (e) {\n return _this2._onopen(e);\n };\n this.socket.onclose = function (e) {\n return _this2._onclose(e);\n };\n this.socket.onmessage = function (e) {\n return _this2._onmessage(e);\n };\n this.socket.onerror = function (e) {\n return _this2._onerror(e);\n };\n }\n }, {\n key: \"disconnect\",\n value: function disconnect() {\n this._connectionDesired = false;\n this._reconnectTimer.stop(); // in case it was running\n\n if (!this._isSocketConnected()) {\n return;\n }\n this._disconnectionReason = 'manual';\n return this.socket.close();\n }\n }, {\n key: \"_scheduleReconnection\",\n value: function _scheduleReconnection() {\n if (!this._connectionDesired) {\n // don't reconnect after manual disconnection\n return;\n }\n if (!this._reconnectTimer.running) {\n this._reconnectTimer.start(this._nextDelay);\n this._nextDelay = Math.min(this.options.maxdelay, this._nextDelay * 2);\n }\n }\n }, {\n key: \"sendCommand\",\n value: function sendCommand(command) {\n if (!this.protocol) {\n return;\n }\n return this._sendCommand(command);\n }\n }, {\n key: \"_sendCommand\",\n value: function _sendCommand(command) {\n return this.socket.send(JSON.stringify(command));\n }\n }, {\n key: \"_closeOnError\",\n value: function _closeOnError() {\n this._handshakeTimeout.stop();\n this._disconnectionReason = 'error';\n return this.socket.close();\n }\n }, {\n key: \"_onopen\",\n value: function _onopen(e) {\n this.handlers.socketConnected();\n this._disconnectionReason = 'handshake-failed';\n\n // start handshake\n var hello = {\n command: 'hello',\n protocols: [PROTOCOL_6, PROTOCOL_7]\n };\n hello.ver = VERSION;\n if (this.options.ext) {\n hello.ext = this.options.ext;\n }\n if (this.options.extver) {\n hello.extver = this.options.extver;\n }\n if (this.options.snipver) {\n hello.snipver = this.options.snipver;\n }\n this._sendCommand(hello);\n return this._handshakeTimeout.start(this.options.handshake_timeout);\n }\n }, {\n key: \"_onclose\",\n value: function _onclose(e) {\n this.protocol = 0;\n this.handlers.disconnected(this._disconnectionReason, this._nextDelay);\n return this._scheduleReconnection();\n }\n }, {\n key: \"_onerror\",\n value: function _onerror(e) {}\n }, {\n key: \"_onmessage\",\n value: function _onmessage(e) {\n return this.protocolParser.process(e.data);\n }\n }]);\n return Connector;\n}();\n;\nexports.Connector = Connector;\n\n},{\"./protocol\":108,\"core-js/modules/es6.array.iterator.js\":85,\"core-js/modules/es6.number.constructor.js\":88,\"core-js/modules/es6.object.to-string.js\":91,\"core-js/modules/es6.string.iterator.js\":98,\"core-js/modules/es6.symbol.js\":99,\"core-js/modules/web.dom.iterable.js\":102}],104:[function(require,module,exports){\n\"use strict\";\n\nvar CustomEvents = {\n bind: function bind(element, eventName, handler) {\n if (element.addEventListener) {\n return element.addEventListener(eventName, handler, false);\n }\n if (element.attachEvent) {\n element[eventName] = 1;\n return element.attachEvent('onpropertychange', function (event) {\n if (event.propertyName === eventName) {\n return handler();\n }\n });\n }\n throw new Error(\"Attempt to attach custom event \".concat(eventName, \" to something which isn't a DOMElement\"));\n },\n fire: function fire(element, eventName) {\n if (element.addEventListener) {\n var event = document.createEvent('HTMLEvents');\n event.initEvent(eventName, true, true);\n return document.dispatchEvent(event);\n } else if (element.attachEvent) {\n if (element[eventName]) {\n return element[eventName]++;\n }\n } else {\n throw new Error(\"Attempt to fire custom event \".concat(eventName, \" on something which isn't a DOMElement\"));\n }\n }\n};\nexports.bind = CustomEvents.bind;\nexports.fire = CustomEvents.fire;\n\n},{}],105:[function(require,module,exports){\n\"use strict\";\n\nrequire(\"core-js/modules/es6.regexp.match.js\");\nrequire(\"core-js/modules/es6.symbol.js\");\nrequire(\"core-js/modules/es6.array.from.js\");\nrequire(\"core-js/modules/es6.string.iterator.js\");\nrequire(\"core-js/modules/es6.object.to-string.js\");\nrequire(\"core-js/modules/es6.array.iterator.js\");\nrequire(\"core-js/modules/web.dom.iterable.js\");\nrequire(\"core-js/modules/es6.number.constructor.js\");\nfunction _typeof(obj) { \"@babel/helpers - typeof\"; return _typeof = \"function\" == typeof Symbol && \"symbol\" == typeof Symbol.iterator ? function (obj) { return typeof obj; } : function (obj) { return obj && \"function\" == typeof Symbol && obj.constructor === Symbol && obj !== Symbol.prototype ? \"symbol\" : typeof obj; }, _typeof(obj); }\nfunction _classCallCheck(instance, Constructor) { if (!(instance instanceof Constructor)) { throw new TypeError(\"Cannot call a class as a function\"); } }\nfunction _defineProperties(target, props) { for (var i = 0; i < props.length; i++) { var descriptor = props[i]; descriptor.enumerable = descriptor.enumerable || false; descriptor.configurable = true; if (\"value\" in descriptor) descriptor.writable = true; Object.defineProperty(target, _toPropertyKey(descriptor.key), descriptor); } }\nfunction _createClass(Constructor, protoProps, staticProps) { if (protoProps) _defineProperties(Constructor.prototype, protoProps); if (staticProps) _defineProperties(Constructor, staticProps); Object.defineProperty(Constructor, \"prototype\", { writable: false }); return Constructor; }\nfunction _toPropertyKey(arg) { var key = _toPrimitive(arg, \"string\"); return _typeof(key) === \"symbol\" ? key : String(key); }\nfunction _toPrimitive(input, hint) { if (_typeof(input) !== \"object\" || input === null) return input; var prim = input[Symbol.toPrimitive]; if (prim !== undefined) { var res = prim.call(input, hint || \"default\"); if (_typeof(res) !== \"object\") return res; throw new TypeError(\"@@toPrimitive must return a primitive value.\"); } return (hint === \"string\" ? String : Number)(input); }\nvar LessPlugin = /*#__PURE__*/function () {\n function LessPlugin(window, host) {\n _classCallCheck(this, LessPlugin);\n this.window = window;\n this.host = host;\n }\n _createClass(LessPlugin, [{\n key: \"reload\",\n value: function reload(path, options) {\n if (this.window.less && this.window.less.refresh) {\n if (path.match(/\\.less$/i)) {\n return this.reloadLess(path);\n }\n if (options.originalPath.match(/\\.less$/i)) {\n return this.reloadLess(options.originalPath);\n }\n }\n return false;\n }\n }, {\n key: \"reloadLess\",\n value: function reloadLess(path) {\n var link;\n var links = function () {\n var result = [];\n for (var _i = 0, _Array$from = Array.from(document.getElementsByTagName('link')); _i < _Array$from.length; _i++) {\n link = _Array$from[_i];\n if (link.href && link.rel.match(/^stylesheet\\/less$/i) || link.rel.match(/stylesheet/i) && link.type.match(/^text\\/(x-)?less$/i)) {\n result.push(link);\n }\n }\n return result;\n }();\n if (links.length === 0) {\n return false;\n }\n for (var _i2 = 0, _Array$from2 = Array.from(links); _i2 < _Array$from2.length; _i2++) {\n link = _Array$from2[_i2];\n link.href = this.host.generateCacheBustUrl(link.href);\n }\n this.host.console.log('LiveReload is asking LESS to recompile all stylesheets');\n this.window.less.refresh(true);\n return true;\n }\n }, {\n key: \"analyze\",\n value: function analyze() {\n return {\n disable: !!(this.window.less && this.window.less.refresh)\n };\n }\n }]);\n return LessPlugin;\n}();\n;\nLessPlugin.identifier = 'less';\nLessPlugin.version = '1.0';\nmodule.exports = LessPlugin;\n\n},{\"core-js/modules/es6.array.from.js\":84,\"core-js/modules/es6.array.iterator.js\":85,\"core-js/modules/es6.number.constructor.js\":88,\"core-js/modules/es6.object.to-string.js\":91,\"core-js/modules/es6.regexp.match.js\":94,\"core-js/modules/es6.string.iterator.js\":98,\"core-js/modules/es6.symbol.js\":99,\"core-js/modules/web.dom.iterable.js\":102}],106:[function(require,module,exports){\n\"use strict\";\n\nrequire(\"core-js/modules/es6.symbol.js\");\nrequire(\"core-js/modules/es6.number.constructor.js\");\nrequire(\"core-js/modules/es6.array.slice.js\");\nrequire(\"core-js/modules/es6.object.to-string.js\");\nrequire(\"core-js/modules/es6.array.from.js\");\nrequire(\"core-js/modules/es6.string.iterator.js\");\nrequire(\"core-js/modules/es6.array.iterator.js\");\nrequire(\"core-js/modules/web.dom.iterable.js\");\nfunction _typeof(obj) { \"@babel/helpers - typeof\"; return _typeof = \"function\" == typeof Symbol && \"symbol\" == typeof Symbol.iterator ? function (obj) { return typeof obj; } : function (obj) { return obj && \"function\" == typeof Symbol && obj.constructor === Symbol && obj !== Symbol.prototype ? \"symbol\" : typeof obj; }, _typeof(obj); }\nrequire(\"core-js/modules/es6.regexp.match.js\");\nrequire(\"core-js/modules/es6.object.keys.js\");\nfunction _createForOfIteratorHelper(o, allowArrayLike) { var it = typeof Symbol !== \"undefined\" && o[Symbol.iterator] || o[\"@@iterator\"]; if (!it) { if (Array.isArray(o) || (it = _unsupportedIterableToArray(o)) || allowArrayLike && o && typeof o.length === \"number\") { if (it) o = it; var i = 0; var F = function F() {}; return { s: F, n: function n() { if (i >= o.length) return { done: true }; return { done: false, value: o[i++] }; }, e: function e(_e) { throw _e; }, f: F }; } throw new TypeError(\"Invalid attempt to iterate non-iterable instance.\\nIn order to be iterable, non-array objects must have a [Symbol.iterator]() method.\"); } var normalCompletion = true, didErr = false, err; return { s: function s() { it = it.call(o); }, n: function n() { var step = it.next(); normalCompletion = step.done; return step; }, e: function e(_e2) { didErr = true; err = _e2; }, f: function f() { try { if (!normalCompletion && it.return != null) it.return(); } finally { if (didErr) throw err; } } }; }\nfunction _unsupportedIterableToArray(o, minLen) { if (!o) return; if (typeof o === \"string\") return _arrayLikeToArray(o, minLen); var n = Object.prototype.toString.call(o).slice(8, -1); if (n === \"Object\" && o.constructor) n = o.constructor.name; if (n === \"Map\" || n === \"Set\") return Array.from(o); if (n === \"Arguments\" || /^(?:Ui|I)nt(?:8|16|32)(?:Clamped)?Array$/.test(n)) return _arrayLikeToArray(o, minLen); }\nfunction _arrayLikeToArray(arr, len) { if (len == null || len > arr.length) len = arr.length; for (var i = 0, arr2 = new Array(len); i < len; i++) arr2[i] = arr[i]; return arr2; }\nfunction _classCallCheck(instance, Constructor) { if (!(instance instanceof Constructor)) { throw new TypeError(\"Cannot call a class as a function\"); } }\nfunction _defineProperties(target, props) { for (var i = 0; i < props.length; i++) { var descriptor = props[i]; descriptor.enumerable = descriptor.enumerable || false; descriptor.configurable = true; if (\"value\" in descriptor) descriptor.writable = true; Object.defineProperty(target, _toPropertyKey(descriptor.key), descriptor); } }\nfunction _createClass(Constructor, protoProps, staticProps) { if (protoProps) _defineProperties(Constructor.prototype, protoProps); if (staticProps) _defineProperties(Constructor, staticProps); Object.defineProperty(Constructor, \"prototype\", { writable: false }); return Constructor; }\nfunction _toPropertyKey(arg) { var key = _toPrimitive(arg, \"string\"); return _typeof(key) === \"symbol\" ? key : String(key); }\nfunction _toPrimitive(input, hint) { if (_typeof(input) !== \"object\" || input === null) return input; var prim = input[Symbol.toPrimitive]; if (prim !== undefined) { var res = prim.call(input, hint || \"default\"); if (_typeof(res) !== \"object\") return res; throw new TypeError(\"@@toPrimitive must return a primitive value.\"); } return (hint === \"string\" ? String : Number)(input); }\n/* global alert */\nvar _require = require('./connector'),\n Connector = _require.Connector;\nvar _require2 = require('./timer'),\n Timer = _require2.Timer;\nvar _require3 = require('./options'),\n Options = _require3.Options;\nvar _require4 = require('./reloader'),\n Reloader = _require4.Reloader;\nvar _require5 = require('./protocol'),\n ProtocolError = _require5.ProtocolError;\nvar LiveReload = /*#__PURE__*/function () {\n function LiveReload(window) {\n var _this = this;\n _classCallCheck(this, LiveReload);\n this.window = window;\n this.listeners = {};\n this.plugins = [];\n this.pluginIdentifiers = {};\n\n // i can haz console?\n this.console = this.window.console && this.window.console.log && this.window.console.error ? this.window.location.href.match(/LR-verbose/) ? this.window.console : {\n log: function log() {},\n error: this.window.console.error.bind(this.window.console)\n } : {\n log: function log() {},\n error: function error() {}\n };\n\n // i can haz sockets?\n if (!(this.WebSocket = this.window.WebSocket || this.window.MozWebSocket)) {\n this.console.error('LiveReload disabled because the browser does not seem to support web sockets');\n return;\n }\n\n // i can haz options?\n if ('LiveReloadOptions' in window) {\n this.options = new Options();\n for (var _i = 0, _Object$keys = Object.keys(window.LiveReloadOptions || {}); _i < _Object$keys.length; _i++) {\n var k = _Object$keys[_i];\n var v = window.LiveReloadOptions[k];\n this.options.set(k, v);\n }\n } else {\n this.options = Options.extract(this.window.document);\n if (!this.options) {\n this.console.error('LiveReload disabled because it could not find its own