Industrialize API:opeanapi, convetions. ...

[pcrespov]

The outcome of this case should define a reliable and systematic workflow to create an API in a service. Achieving these properties will lead to

• reducing the time of creation while preserving quality
• producing a maintainable api
• accurately estimate any modification/extension of the api

Steps

• API: standard procedure to create openapi specs
• API: autogeneration of code for server stub and client sdk (includes some scripting functionality)
• services naming (module, scripting entrypoint, package, ...)
• services configuration and schemas
• services and sdk's versioning
• service Dockerfiles (i.e. non-root user, boot, entrypoint scripts, targets, ...)
• python project skeleton (cookiecutter?)

[pcrespov]

Versioning

see output of pip ... how to sync all versions of sdk and services

simcore-director-sdk      1.0.0
simcore-sdk               0.1.0
simcore-service-webserver 0.0.0