{"id":14986770,"url":"https://github.com/playpauseandstop/rororo","last_synced_at":"2026-04-01T22:05:49.654Z","repository":{"id":650797,"uuid":"6331465","full_name":"playpauseandstop/rororo","owner":"playpauseandstop","description":"Implement aiohttp.web OpenAPI 3 server applications with schema first approach.","archived":false,"fork":false,"pushed_at":"2024-12-24T00:41:21.000Z","size":1929,"stargazers_count":106,"open_issues_count":20,"forks_count":10,"subscribers_count":4,"default_branch":"main","last_synced_at":"2026-03-27T15:25:28.592Z","etag":null,"topics":["aiohttp","aiohttp-server","asyncio","openapi","openapi3","python","python-3","python-3-10","python-3-11","python-3-7","python-3-8","python-3-9","python-library","python3"],"latest_commit_sha":null,"homepage":"https://rororo.readthedocs.io","language":"Python","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"bsd-3-clause","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/playpauseandstop.png","metadata":{"files":{"readme":"README.rst","changelog":"CHANGELOG.rst","contributing":null,"funding":null,"license":"LICENSE","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null}},"created_at":"2012-10-22T08:08:52.000Z","updated_at":"2025-12-07T18:11:19.000Z","dependencies_parsed_at":"2024-11-16T17:33:57.247Z","dependency_job_id":"4e873adf-57c7-4b53-a7a5-23d78f16b687","html_url":"https://github.com/playpauseandstop/rororo","commit_stats":{"total_commits":542,"total_committers":10,"mean_commits":54.2,"dds":0.4022140221402214,"last_synced_commit":"66eacb85dbc5a97ce6115e746711e02e5d022845"},"previous_names":[],"tags_count":48,"template":false,"template_full_name":null,"purl":"pkg:github/playpauseandstop/rororo","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/playpauseandstop%2Frororo","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/playpauseandstop%2Frororo/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/playpauseandstop%2Frororo/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/playpauseandstop%2Frororo/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/playpauseandstop","download_url":"https://codeload.github.com/playpauseandstop/rororo/tar.gz/refs/heads/main","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/playpauseandstop%2Frororo/sbom","scorecard":{"id":737533,"data":{"date":"2025-08-11","repo":{"name":"github.com/playpauseandstop/rororo","commit":"66eacb85dbc5a97ce6115e746711e02e5d022845"},"scorecard":{"version":"v5.2.1-40-gf6ed084d","commit":"f6ed084d17c9236477efd66e5b258b9d4cc7b389"},"score":2.9,"checks":[{"name":"Code-Review","score":0,"reason":"Found 0/9 approved changesets -- score normalized to 0","details":null,"documentation":{"short":"Determines if the project requires human code review before pull requests (aka merge requests) are merged.","url":"https://github.com/ossf/scorecard/blob/f6ed084d17c9236477efd66e5b258b9d4cc7b389/docs/checks.md#code-review"}},{"name":"Maintained","score":0,"reason":"0 commit(s) and 0 issue activity found in the last 90 days -- score normalized to 0","details":null,"documentation":{"short":"Determines if the project is \"actively maintained\".","url":"https://github.com/ossf/scorecard/blob/f6ed084d17c9236477efd66e5b258b9d4cc7b389/docs/checks.md#maintained"}},{"name":"Binary-Artifacts","score":10,"reason":"no binaries found in the repo","details":null,"documentation":{"short":"Determines if the project has generated executable (binary) artifacts in the source repository.","url":"https://github.com/ossf/scorecard/blob/f6ed084d17c9236477efd66e5b258b9d4cc7b389/docs/checks.md#binary-artifacts"}},{"name":"Dangerous-Workflow","score":10,"reason":"no dangerous workflow patterns detected","details":null,"documentation":{"short":"Determines if the project's GitHub Action workflows avoid dangerous patterns.","url":"https://github.com/ossf/scorecard/blob/f6ed084d17c9236477efd66e5b258b9d4cc7b389/docs/checks.md#dangerous-workflow"}},{"name":"CII-Best-Practices","score":0,"reason":"no effort to earn an OpenSSF best practices badge detected","details":null,"documentation":{"short":"Determines if the project has an OpenSSF (formerly CII) Best Practices Badge.","url":"https://github.com/ossf/scorecard/blob/f6ed084d17c9236477efd66e5b258b9d4cc7b389/docs/checks.md#cii-best-practices"}},{"name":"Token-Permissions","score":0,"reason":"detected GitHub workflow tokens with excessive permissions","details":["Warn: no topLevel permission defined: .github/workflows/ci.yml:1","Warn: no topLevel permission defined: .github/workflows/ci_package.yml:1","Warn: no topLevel permission defined: .github/workflows/ci_release.yml:1","Warn: no topLevel permission defined: .github/workflows/ci_verify_docs_build.yml:1","Warn: no topLevel permission defined: .github/workflows/release_pr.yml:1","Warn: no topLevel permission defined: .github/workflows/release_tag.yml:1","Info: no jobLevel write permissions found"],"documentation":{"short":"Determines if the project's workflows follow the principle of least privilege.","url":"https://github.com/ossf/scorecard/blob/f6ed084d17c9236477efd66e5b258b9d4cc7b389/docs/checks.md#token-permissions"}},{"name":"Pinned-Dependencies","score":0,"reason":"dependency not pinned by hash detected -- score normalized to 0","details":["Warn: GitHub-owned GitHubAction not pinned by hash: .github/workflows/ci.yml:32: update your workflow using https://app.stepsecurity.io/secureworkflow/playpauseandstop/rororo/ci.yml/main?enable=pin","Warn: GitHub-owned GitHubAction not pinned by hash: .github/workflows/ci.yml:76: update your workflow using https://app.stepsecurity.io/secureworkflow/playpauseandstop/rororo/ci.yml/main?enable=pin","Warn: GitHub-owned GitHubAction not pinned by hash: .github/workflows/ci_package.yml:19: update your workflow using https://app.stepsecurity.io/secureworkflow/playpauseandstop/rororo/ci_package.yml/main?enable=pin","Warn: third-party GitHubAction not pinned by hash: .github/workflows/ci_package.yml:37: update your workflow using https://app.stepsecurity.io/secureworkflow/playpauseandstop/rororo/ci_package.yml/main?enable=pin","Warn: GitHub-owned GitHubAction not pinned by hash: .github/workflows/ci_release.yml:17: update your workflow using https://app.stepsecurity.io/secureworkflow/playpauseandstop/rororo/ci_release.yml/main?enable=pin","Warn: GitHub-owned GitHubAction not pinned by hash: .github/workflows/ci_release.yml:33: update your workflow using https://app.stepsecurity.io/secureworkflow/playpauseandstop/rororo/ci_release.yml/main?enable=pin","Warn: GitHub-owned GitHubAction not pinned by hash: .github/workflows/ci_verify_docs_build.yml:17: update your workflow using https://app.stepsecurity.io/secureworkflow/playpauseandstop/rororo/ci_verify_docs_build.yml/main?enable=pin","Warn: GitHub-owned GitHubAction not pinned by hash: .github/workflows/release_pr.yml:26: update your workflow using https://app.stepsecurity.io/secureworkflow/playpauseandstop/rororo/release_pr.yml/main?enable=pin","Warn: third-party GitHubAction not pinned by hash: .github/workflows/release_pr.yml:44: update your workflow using https://app.stepsecurity.io/secureworkflow/playpauseandstop/rororo/release_pr.yml/main?enable=pin","Warn: third-party GitHubAction not pinned by hash: .github/workflows/release_pr.yml:50: update your workflow using https://app.stepsecurity.io/secureworkflow/playpauseandstop/rororo/release_pr.yml/main?enable=pin","Warn: third-party GitHubAction not pinned by hash: .github/workflows/release_tag.yml:23: update your workflow using https://app.stepsecurity.io/secureworkflow/playpauseandstop/rororo/release_tag.yml/main?enable=pin","Warn: GitHub-owned GitHubAction not pinned by hash: .github/workflows/release_tag.yml:28: update your workflow using https://app.stepsecurity.io/secureworkflow/playpauseandstop/rororo/release_tag.yml/main?enable=pin","Info:   0 out of   8 GitHub-owned GitHubAction dependencies pinned","Info:   0 out of   4 third-party GitHubAction dependencies pinned"],"documentation":{"short":"Determines if the project has declared and pinned the dependencies of its build process.","url":"https://github.com/ossf/scorecard/blob/f6ed084d17c9236477efd66e5b258b9d4cc7b389/docs/checks.md#pinned-dependencies"}},{"name":"Security-Policy","score":0,"reason":"security policy file not detected","details":["Warn: no security policy file detected","Warn: no security file to analyze","Warn: no security file to analyze","Warn: no security file to analyze"],"documentation":{"short":"Determines if the project has published a security policy.","url":"https://github.com/ossf/scorecard/blob/f6ed084d17c9236477efd66e5b258b9d4cc7b389/docs/checks.md#security-policy"}},{"name":"License","score":10,"reason":"license file detected","details":["Info: project has a license file: LICENSE:0","Info: FSF or OSI recognized license: BSD 3-Clause \"New\" or \"Revised\" License: LICENSE:0"],"documentation":{"short":"Determines if the project has defined a license.","url":"https://github.com/ossf/scorecard/blob/f6ed084d17c9236477efd66e5b258b9d4cc7b389/docs/checks.md#license"}},{"name":"Signed-Releases","score":-1,"reason":"no releases found","details":null,"documentation":{"short":"Determines if the project cryptographically signs release artifacts.","url":"https://github.com/ossf/scorecard/blob/f6ed084d17c9236477efd66e5b258b9d4cc7b389/docs/checks.md#signed-releases"}},{"name":"Fuzzing","score":0,"reason":"project is not fuzzed","details":["Warn: no fuzzer integrations found"],"documentation":{"short":"Determines if the project uses fuzzing.","url":"https://github.com/ossf/scorecard/blob/f6ed084d17c9236477efd66e5b258b9d4cc7b389/docs/checks.md#fuzzing"}},{"name":"Branch-Protection","score":-1,"reason":"internal error: error during branchesHandler.setup: internal error: githubv4.Query: Resource not accessible by integration","details":null,"documentation":{"short":"Determines if the default and release branches are protected with GitHub's branch protection settings.","url":"https://github.com/ossf/scorecard/blob/f6ed084d17c9236477efd66e5b258b9d4cc7b389/docs/checks.md#branch-protection"}},{"name":"Packaging","score":-1,"reason":"packaging workflow not detected","details":["Warn: no GitHub/GitLab publishing workflow detected."],"documentation":{"short":"Determines if the project is published as a package that others can easily download, install, easily update, and uninstall.","url":"https://github.com/ossf/scorecard/blob/f6ed084d17c9236477efd66e5b258b9d4cc7b389/docs/checks.md#packaging"}},{"name":"Vulnerabilities","score":0,"reason":"14 existing vulnerabilities detected","details":["Warn: Project is vulnerable to: GHSA-8495-4g3g-x7pr","Warn: Project is vulnerable to: GHSA-9548-qrrj-x5pj","Warn: Project is vulnerable to: GHSA-79v4-65xg-pq4g","Warn: Project is vulnerable to: GHSA-cpwx-vrp4-4pq7","Warn: Project is vulnerable to: GHSA-gmj6-6f8f-6699","Warn: Project is vulnerable to: GHSA-q2x7-8rv6-6q7h","Warn: Project is vulnerable to: GHSA-9hjg-9r4m-mvj7","Warn: Project is vulnerable to: PYSEC-2025-49 / GHSA-5rjg-fvgr-3xxf","Warn: Project is vulnerable to: GHSA-7cx3-6m66-7c5m","Warn: Project is vulnerable to: GHSA-8w49-h785-mj3c","Warn: Project is vulnerable to: GHSA-48p4-8xcf-vxj5","Warn: Project is vulnerable to: GHSA-pq67-6m6q-mj2v","Warn: Project is vulnerable to: GHSA-f9vj-2wh5-fj8j","Warn: Project is vulnerable to: GHSA-q34m-jh98-gwm2"],"documentation":{"short":"Determines if the project has open, known unfixed vulnerabilities.","url":"https://github.com/ossf/scorecard/blob/f6ed084d17c9236477efd66e5b258b9d4cc7b389/docs/checks.md#vulnerabilities"}},{"name":"SAST","score":2,"reason":"SAST tool is not run on all commits -- score normalized to 2","details":["Warn: 7 commits out of 30 are checked with a SAST tool"],"documentation":{"short":"Determines if the project uses static code analysis.","url":"https://github.com/ossf/scorecard/blob/f6ed084d17c9236477efd66e5b258b9d4cc7b389/docs/checks.md#sast"}}]},"last_synced_at":"2025-08-22T16:20:05.393Z","repository_id":650797,"created_at":"2025-08-22T16:20:05.393Z","updated_at":"2025-08-22T16:20:05.393Z"},"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":286080680,"owners_count":31058993,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2026-03-27T19:32:53.857Z","status":"ssl_error","status_checked_at":"2026-03-27T19:32:45.136Z","response_time":164,"last_error":"SSL_connect returned=1 errno=0 peeraddr=140.82.121.6:443 state=error: unexpected eof while reading","robots_txt_status":"success","robots_txt_updated_at":"2025-07-24T06:49:26.215Z","robots_txt_url":"https://github.com/robots.txt","online":false,"can_crawl_api":true,"host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["aiohttp","aiohttp-server","asyncio","openapi","openapi3","python","python-3","python-3-10","python-3-11","python-3-7","python-3-8","python-3-9","python-library","python3"],"created_at":"2024-09-24T14:13:29.887Z","updated_at":"2026-04-01T22:05:49.599Z","avatar_url":"https://github.com/playpauseandstop.png","language":"Python","readme":"======\nrororo\n======\n\n.. image:: https://github.com/playpauseandstop/rororo/actions/workflows/ci.yml/badge.svg\n    :target: https://github.com/playpauseandstop/rororo/actions/workflows/ci.yml\n    :alt: CI Workflow\n\n.. image:: https://img.shields.io/badge/pre--commit-enabled-brightgreen?logo=pre-commit\u0026logoColor=white\n    :target: https://github.com/pre-commit/pre-commit\n    :alt: pre-commit\n\n.. image:: https://img.shields.io/badge/code%20style-black-000000.svg\n    :target: https://github.com/psf/black\n    :alt: black\n\n.. image:: https://img.shields.io/pypi/v/rororo.svg\n    :target: https://pypi.org/project/rororo/\n    :alt: Latest Version\n\n.. image:: https://img.shields.io/pypi/pyversions/rororo.svg\n    :target: https://pypi.org/project/rororo/\n    :alt: Python versions\n\n.. image:: https://img.shields.io/pypi/l/rororo.svg\n    :target: https://github.com/playpauseandstop/rororo/blob/main/LICENSE\n    :alt: BSD License\n\n.. image:: https://coveralls.io/repos/playpauseandstop/rororo/badge.svg?branch=main\u0026service=github\n    :target: https://coveralls.io/github/playpauseandstop/rororo\n    :alt: Coverage\n\n.. image:: https://readthedocs.org/projects/rororo/badge/?version=latest\n    :target: https://rororo.readthedocs.io/\n    :alt: Documentation\n\nImplement `aiohttp.web`_ `OpenAPI 3`_ server applications with schema first\napproach.\n\nAs well as bunch other utilities to build effective server applications with\n`Python`_ 3 \u0026 `aiohttp.web`_.\n\n* Works on `Python`_ 3.8+\n* Works with `aiohttp.web`_ 3.8.1+\n* BSD licensed\n* Source, issues, and pull requests `on GitHub\n  \u003chttps://github.com/playpauseandstop/rororo\u003e`_\n\n.. _`OpenAPI 3`: https://spec.openapis.org/oas/v3.0.3\n.. _`aiohttp.web`: https://docs.aiohttp.org/en/stable/web.html\n.. _`Python`: https://www.python.org/\n\nQuick Start\n===========\n\n*rororo* relies on valid OpenAPI 3 schema file (both JSON or YAML formats\nsupported).\n\nExample below, illustrates on how to handle operation ``hello_world`` from\n`openapi.yaml`_ schema file.\n\n.. code-block:: python\n\n    from pathlib import Path\n\n    from aiohttp import web\n    from rororo import (\n        openapi_context,\n        OperationTableDef,\n        setup_openapi,\n    )\n\n\n    operations = OperationTableDef()\n\n\n    @operations.register\n    async def hello_world(request: web.Request) -\u003e web.Response:\n        with openapi_context(request) as context:\n            name = context.parameters.query.get(\"name\", \"world\")\n            email = context.parameters.query.get(\n                \"email\", \"world@example.com\"\n            )\n            return web.json_response(\n                {\"message\": f\"Hello, {name}!\", \"email\": email}\n            )\n\n\n    def create_app(argv: list[str] = None) -\u003e web.Application:\n        return setup_openapi(\n            web.Application(),\n            Path(__file__).parent / \"openapi.yaml\",\n            operations,\n            server_url=\"/api\",\n        )\n\n.. _`openapi.yaml`: https://github.com/playpauseandstop/rororo/blob/main/tests/rororo/openapi.yaml\n\nSchema First Approach\n---------------------\n\nUnlike other popular Python OpenAPI 3 solutions, such as\n`Django REST Framework`_, `FastAPI`_,  `flask-apispec`_, or `aiohttp-apispec`_\n*rororo* **requires** you to provide valid `OpenAPI 3`_ schema first. This\nmakes *rororo* similar to `connexion`_, `pyramid_openapi3`_ and other schema\nfirst libraries.\n\n.. _`Django REST Framework`: https://www.django-rest-framework.org\n.. _`FastAPI`: https://fastapi.tiangolo.com\n.. _`flask-apispec`: https://flask-apispec.readthedocs.io\n.. _`aiohttp-apispec`: https://aiohttp-apispec.readthedocs.io\n.. _`connexion`: https://connexion.readthedocs.io\n.. _`pyramid_openapi3`: https://github.com/Pylons/pyramid_openapi3\n\nClass Based Views\n-----------------\n\n*rororo* supports `class based views`_ as well. `Todo-Backend`_ example\nillustrates how to use class based views for OpenAPI 3 servers.\n\nIn snippet below, *rororo* expects that OpenAPI 3 schema contains operation ID\n``UserView.get``,\n\n.. code-block:: python\n\n    @operations.register\n    class UserView(web.View):\n        async def get(self) -\u003e web.Response: ...\n\n\n.. _`class based views`: https://docs.aiohttp.org/en/stable/web_quickstart.html#aiohttp-web-class-based-views\n.. _`Todo-Backend`: https://github.com/playpauseandstop/rororo/tree/main/examples/todobackend\n\nMore Examples\n-------------\n\nCheck `examples`_ folder to see other examples on how to build aiohttp.web\nOpenAPI 3 server applications.\n\n.. _`examples`: https://github.com/playpauseandstop/rororo/tree/main/examples\n","funding_links":[],"categories":[],"sub_categories":[],"project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fplaypauseandstop%2Frororo","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fplaypauseandstop%2Frororo","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fplaypauseandstop%2Frororo/lists"}