{"id":16889735,"url":"https://github.com/viatorus/dispono","last_synced_at":"2025-10-27T18:40:31.872Z","repository":{"id":162266964,"uuid":"233560487","full_name":"Viatorus/dispono","owner":"Viatorus","description":"Dispono synchronizes your source code and runs it inside a browser IDE.","archived":false,"fork":false,"pushed_at":"2020-01-15T19:34:55.000Z","size":87,"stargazers_count":2,"open_issues_count":0,"forks_count":0,"subscribers_count":1,"default_branch":"master","last_synced_at":"2025-03-20T07:39:50.033Z","etag":null,"topics":[],"latest_commit_sha":null,"homepage":"","language":"Python","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"mit","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/Viatorus.png","metadata":{"files":{"readme":"README.md","changelog":null,"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":"2020-01-13T09:38:54.000Z","updated_at":"2024-04-02T19:12:30.000Z","dependencies_parsed_at":null,"dependency_job_id":"ff6f79bb-5b12-44c6-b249-6e6c9e884491","html_url":"https://github.com/Viatorus/dispono","commit_stats":null,"previous_names":[],"tags_count":1,"template":false,"template_full_name":null,"purl":"pkg:github/Viatorus/dispono","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/Viatorus%2Fdispono","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/Viatorus%2Fdispono/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/Viatorus%2Fdispono/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/Viatorus%2Fdispono/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/Viatorus","download_url":"https://codeload.github.com/Viatorus/dispono/tar.gz/refs/heads/master","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/Viatorus%2Fdispono/sbom","scorecard":null,"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":281322869,"owners_count":26481547,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2022-07-04T15:15:14.044Z","status":"online","status_checked_at":"2025-10-27T02:00:05.855Z","response_time":61,"last_error":null,"robots_txt_status":"success","robots_txt_updated_at":"2025-07-24T06:49:26.215Z","robots_txt_url":"https://github.com/robots.txt","online":true,"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":[],"created_at":"2024-10-13T16:58:40.007Z","updated_at":"2025-10-27T18:40:31.856Z","avatar_url":"https://github.com/Viatorus.png","language":"Python","funding_links":[],"categories":[],"sub_categories":[],"readme":"![logo](https://raw.githubusercontent.com/Viatorus/dispono/master/artwork/logo_banner.png)\n\n# Dispono\nDispono is a tool to synchronization your source code and run it inside a browser IDE.\n\nIt works cross-platform and cross-browser since it doesn't requires any plugins.\n\nCurrently supported browser IDE's:\n* [CodinGame](https://www.codingame.com/)\n\n## Installation\n\n```\npip install dispono\n```\n\nOnly **Python 3.6+** is supported.\n\n## Usage\n\n1. Write a python script:\n    ```python\n    from dispono import Dispono\n   \n   \n    async def task(ide):\n        await ide.sync_code('print(\"Hello browser. :)\")')\n        await ide.run_code()\n    \n   \n    Dispono(task, port=8080)\n    ```\n    The above code will open a server at port 8080, transfer the code to your browser IDE and run the code.   \n\n2. Open your browser IDE (e.g. a CodinGame contest).\n\n3. Run the python script.\n    \n   When you start the script the first time, you have to execute a small javascript snippet inside the browser tab web\n   console in order to connect to the server.\n\n   All following runs will work out of the box for the same session.\n\n## Advanced usage\n\n### C/C++\n\nIn combination with [Quom](https://github.com/Viatorus/quom), your multi-file C/C++ project can be easily synced with \nyour web IDE. Quom generates a single file from all local included header and source files.\n\n```python\nfrom io import StringIO\n\nfrom dispono import Dispono\nfrom quom import Quom\n\n\nasync def task(ide):\n    dst = StringIO()\n    Quom('main.cpp', dst)\n    await ide.sync_code(dst.getvalue())\n    await ide.run_code()\n\n\nDispono(task, port=8080)\n```\n\n## How does it work\n\nDispono starts a lightweight web server serving a javascript file for your specific browser IDE.\n\nThe javascript file contains code to control the IDE (sync/run/get output) and a client instance.\n\nAfter registration the client by the server, the server can send commands to the client.\n \nThe communication between server and client happens with [socket.io](https://socket.io/). \n\n## Planned features\n\n* Download code from web IDE.\n* Correctly forward console output to the server.\n* Support more web IDE's.\n* Support multiple clients at the same time.\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fviatorus%2Fdispono","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fviatorus%2Fdispono","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fviatorus%2Fdispono/lists"}