labthings / python-labthings

Python implementation of LabThings, based on the Flask microframework
GNU General Public License v3.0
18 stars 2 forks source link

Off-topic: OpenAPI/Swagger Compiler for Server Stubs (ESP32) ? #302

Open beniroquai opened 2 years ago

beniroquai commented 2 years ago

Hey @jtc42, sorry that I cross-spam here. I'm trying to get the labthings into the ESP32's. You already put a lot of effort into the ESP branch of this project and I was wondering if you are aware of any project/code that aims to compile the server stubs for an ESP32 from an openapi.json API description. By the way, did you document any of your work for the ESPs somewhere?

Best Benedict

jtc42 commented 2 years ago

Hi Benedict!

Not aware of any other projects doing this specifically, but that's not to say they don't exist! I'm a bit out of the loop since I'm no longer working on this project.

The only ESP library documentation is whatever lives in the archived repo (https://github.com/labthings/esp-thingserver), however it was a VERY early an unfinished fork of the Mozilla Web Things library and so never really made it to "production-ready" status.

Sorry I can't be more help! Are you happy for me to close the issue here? I'm not sure the best place for conversations like this, but someone may be able to create a better forum if the demand is there.

beniroquai commented 2 years ago

Thanks for your response! Right now I'm just trying to collect some ideas how a one-fits-all solution could look like. I found this blog entry: https://techtutorialsx.com/2017/05/28/esp8266-adding-swagger-ui-to-rest-api/ and it works (just now :-). Swagger UI on the ESP32. I discussed some aspects around this topic with @rwb27 recently. Ideally we have a simple integration of our small modules / cubes into some easy-to-use framework (>labthings). And even more ideal: Everything should work out of the box. I'll start going through the code. I think that's the best for now?

Thanks!