♻️ api-server: openapi docs and versioning

[pcrespov]

What do these changes do?

None critical changes for the api-server to align with the new release strategy developed for the client in ITISFoundation/osparc-simcore-clients#180

• 📝 new formatted messages for changelog
• ♻️ new version identifier if API_SERVER_DEV_FEATURES_ENABLED=1
  - the OAS exposes all entrypoint (some are hidden in production)
  - Changes to a development version M.m.p.post0.dev
  - The resulting OAS can be obtained also using make openapi-dev.json
• 📝 makefile recipes to produce OAS diffs between different versions

Related issue/s

• Part of request functionalities of osparc python api client for ti-simu osparc-issues#1611

How to test

Dev-ops checklist

None

[codecov]

Codecov Report

Attention: Patch coverage is 92.00000% with 2 lines in your changes missing coverage. Please review.

Project coverage is 67.0%. Comparing base (cafbf96) to head (4ac262a).
Report is 485 commits behind head on master.

Files with missing lines	Patch %	Lines
...src/simcore_service_api_server/core/application.py	83.3%	2 Missing ⚠️

Additional details and impacted files

@@            Coverage Diff            @@
##           master   #6264      +/-   ##
=========================================
- Coverage    84.5%   67.0%   -17.6%     
=========================================
  Files          10     657     +647     
  Lines         214   32230   +32016     
  Branches       25     260     +235     
=========================================
+ Hits          181   21600   +21419     
- Misses         23   10570   +10547     
- Partials       10      60      +50     

Flag	Coverage Δ
integrationtests	64.8% <ø> (?)
unittests	89.8% <92.0%> (+5.2%)	⬆️

Flags with carried forward coverage won't be shown. Click here to find out more.

Files with missing lines	Coverage Δ
...imcore_service_api_server/api/routes/_constants.py	100.0% <100.0%> (ø)
...c/simcore_service_api_server/api/routes/credits.py	100.0% <100.0%> (ø)
...src/simcore_service_api_server/api/routes/files.py	78.5% <ø> (ø)
...c/simcore_service_api_server/api/routes/solvers.py	65.4% <100.0%> (ø)
...core_service_api_server/api/routes/solvers_jobs.py	100.0% <100.0%> (ø)
...vice_api_server/api/routes/solvers_jobs_getters.py	93.3% <100.0%> (ø)
...c/simcore_service_api_server/api/routes/studies.py	100.0% <100.0%> (ø)
...core_service_api_server/api/routes/studies_jobs.py	94.1% <100.0%> (ø)
...src/simcore_service_api_server/core/application.py	94.1% <83.3%> (ø)

... and 658 files with indirect coverage changes

[matusdrobuliak66]

Thanks!

[sanderegg]

thanks

[sonarqubecloud]

Quality Gate passed

Issues
0 New issues
0 Accepted issues

Measures
0 Security Hotspots
0.0% Coverage on New Code
0.0% Duplication on New Code

See analysis details on SonarCloud