OpenCyphal / nunaweb

A web UI for transcompiling DSDL via Nunavut.

Home Page:https://nunaweb.opencyphal.org/

Geek Repo:Geek Repo

Github PK Tool:Github PK Tool

nunaweb

A web UI for generating code for DSDL via Nunavut.

Nunaweb screenshot

Nunaweb makes it easy to generate code for DSDL namespaces from the web. Simply upload your namespaces as .zip archives (or provide a remote link) and hit Submit. The web UI will display the commands needed to generate the code with the specified settings, and then compile your namespaces into the specified target language.

The application is deployed to production at https://nunaweb.opencyphal.org.

Setting up a development environment

Nunaweb uses Vue/Nuxt.js on the frontend and Flask on the backend. It uses Nunavut to generate code.

Clone the repository to get started.

Frontend setup

cd into the nunaweb/ directory (which contains the frontend) and run npm install. From there, you can run npm run dev to start a development server.

Backend setup

Because the backend requires several services to be running, we've simplified startup with a docker-compose file.

  1. Install Docker or a compatible container runtime.
  2. Install Docker-Compose.
  3. Install requirements locally with pip3 install -r requirements.txt.
  4. Spin up the backend server with docker-compose up (make sure you add your user to the docker group; otherwise you may have to use sudo.)

You should now have a development environment set up.

Contributing

Interested in contributing? You can file issues for bug fixes and improvements or submit PRs to improve the code.

About

A web UI for transcompiling DSDL via Nunavut.

https://nunaweb.opencyphal.org/

License:MIT License


Languages

Language:Python 49.6%Language:Vue 32.6%Language:JavaScript 16.8%Language:Dockerfile 1.0%