🎨 Drafts new web-api for catalog services

[pcrespov]

What do these changes do?

This PR drafts new entrypoints for the web-api for catalog/services collection. Specifically

These entrypoints have been redesigned to:

• reduce the amount of items in the responses
• include service history (i.e all version)
• resolve version compatibility

NOTE: these entrypoints are only available with WEBSERVER_DEV_FEATURES_ENABLED=1, i.e. only available in master for testing.

Hightlights

• ⚗️ Drafts new API to list, get and update a service
  • list operation only returns only latest versions of each service (in contrast to the previous implementation that returned every single version). This already will drastically reduce the amount of items listed.
  • list includes pagination
  • To get the information of other versions, the new model includes a history field with with all the releases of the service.
  • history also includes information on version compatibility that will now be resolved in the backend. Therefore, given a service,
    • the latest compatible version is found under history[*].compatibility.can_update_to
    • the latest version of that service is history[0]
• ♻️ Organized service_metadata_... model variants
• 🔨 increase test coverage of labels_annotations module
• 🔨 ♻️ refactors catalog plugin tests

Related issue/s

• resolves part of https://github.com/ITISFoundation/osparc-simcore/issues/5964
• driving test services/web/server/tests/unit/with_dbs/01/test_catalog_handlers__services.py

How to test

• Setup local deploy or in master and manually test dev entrypoints. They provide fake data but it is consistent with new models

Dev-ops checklist

None

[codecov[bot]]

Codecov Report

All modified and coverable lines are covered by tests :white_check_mark:

Project coverage is 86.3%. Comparing base (cafbf96) to head (53ff2cf). Report is 291 commits behind head on master.

Additional details and impacted files

[](https://app.codecov.io/gh/ITISFoundation/osparc-simcore/pull/5969?src=pr&el=tree&utm_medium=referral&utm_source=github&utm_content=comment&utm_campaign=pr+comments&utm_term=ITISFoundation) ```diff @@ Coverage Diff @@ ## master #5969 +/- ## ========================================= + Coverage 84.5% 86.3% +1.7% ========================================= Files 10 1161 +1151 Lines 214 50763 +50549 Branches 25 562 +537 ========================================= + Hits 181 43843 +43662 - Misses 23 6794 +6771 - Partials 10 126 +116 ``` | [Flag](https://app.codecov.io/gh/ITISFoundation/osparc-simcore/pull/5969/flags?src=pr&el=flags&utm_medium=referral&utm_source=github&utm_content=comment&utm_campaign=pr+comments&utm_term=ITISFoundation) | Coverage Δ | | |---|---|---| | [integrationtests](https://app.codecov.io/gh/ITISFoundation/osparc-simcore/pull/5969/flags?src=pr&el=flag&utm_medium=referral&utm_source=github&utm_content=comment&utm_campaign=pr+comments&utm_term=ITISFoundation) | `64.7% <41.6%> (?)` | | | [unittests](https://app.codecov.io/gh/ITISFoundation/osparc-simcore/pull/5969/flags?src=pr&el=flag&utm_medium=referral&utm_source=github&utm_content=comment&utm_campaign=pr+comments&utm_term=ITISFoundation) | `86.4% <100.0%> (+1.8%)` | :arrow_up: | Flags with carried forward coverage won't be shown. [Click here](https://docs.codecov.io/docs/carryforward-flags?utm_medium=referral&utm_source=github&utm_content=comment&utm_campaign=pr+comments&utm_term=ITISFoundation#carryforward-flags-in-the-pull-request-comment) to find out more. | [Files](https://app.codecov.io/gh/ITISFoundation/osparc-simcore/pull/5969?dropdown=coverage&src=pr&el=tree&utm_medium=referral&utm_source=github&utm_content=comment&utm_campaign=pr+comments&utm_term=ITISFoundation) | Coverage Δ | | |---|---|---| | [...src/models\_library/api\_schemas\_catalog/services.py](https://app.codecov.io/gh/ITISFoundation/osparc-simcore/pull/5969?src=pr&el=tree&filepath=packages%2Fmodels-library%2Fsrc%2Fmodels_library%2Fapi_schemas_catalog%2Fservices.py&utm_medium=referral&utm_source=github&utm_content=comment&utm_campaign=pr+comments&utm_term=ITISFoundation#diff-cGFja2FnZXMvbW9kZWxzLWxpYnJhcnkvc3JjL21vZGVsc19saWJyYXJ5L2FwaV9zY2hlbWFzX2NhdGFsb2cvc2VydmljZXMucHk=) | `100.0% <100.0%> (ø)` | | | [...rc/models\_library/api\_schemas\_webserver/catalog.py](https://app.codecov.io/gh/ITISFoundation/osparc-simcore/pull/5969?src=pr&el=tree&filepath=packages%2Fmodels-library%2Fsrc%2Fmodels_library%2Fapi_schemas_webserver%2Fcatalog.py&utm_medium=referral&utm_source=github&utm_content=comment&utm_campaign=pr+comments&utm_term=ITISFoundation#diff-cGFja2FnZXMvbW9kZWxzLWxpYnJhcnkvc3JjL21vZGVsc19saWJyYXJ5L2FwaV9zY2hlbWFzX3dlYnNlcnZlci9jYXRhbG9nLnB5) | `100.0% <100.0%> (ø)` | | | [...ages/models-library/src/models\_library/services.py](https://app.codecov.io/gh/ITISFoundation/osparc-simcore/pull/5969?src=pr&el=tree&filepath=packages%2Fmodels-library%2Fsrc%2Fmodels_library%2Fservices.py&utm_medium=referral&utm_source=github&utm_content=comment&utm_campaign=pr+comments&utm_term=ITISFoundation#diff-cGFja2FnZXMvbW9kZWxzLWxpYnJhcnkvc3JjL21vZGVsc19saWJyYXJ5L3NlcnZpY2VzLnB5) | `100.0% <100.0%> (ø)` | | | [...s/models-library/src/models\_library/services\_db.py](https://app.codecov.io/gh/ITISFoundation/osparc-simcore/pull/5969?src=pr&el=tree&filepath=packages%2Fmodels-library%2Fsrc%2Fmodels_library%2Fservices_db.py&utm_medium=referral&utm_source=github&utm_content=comment&utm_campaign=pr+comments&utm_term=ITISFoundation#diff-cGFja2FnZXMvbW9kZWxzLWxpYnJhcnkvc3JjL21vZGVsc19saWJyYXJ5L3NlcnZpY2VzX2RiLnB5) | `100.0% <100.0%> (ø)` | | | [...els-library/src/models\_library/services\_history.py](https://app.codecov.io/gh/ITISFoundation/osparc-simcore/pull/5969?src=pr&el=tree&filepath=packages%2Fmodels-library%2Fsrc%2Fmodels_library%2Fservices_history.py&utm_medium=referral&utm_source=github&utm_content=comment&utm_campaign=pr+comments&utm_term=ITISFoundation#diff-cGFja2FnZXMvbW9kZWxzLWxpYnJhcnkvc3JjL21vZGVsc19saWJyYXJ5L3NlcnZpY2VzX2hpc3RvcnkucHk=) | `100.0% <100.0%> (ø)` | | | [...y/src/models\_library/services\_metadata\_editable.py](https://app.codecov.io/gh/ITISFoundation/osparc-simcore/pull/5969?src=pr&el=tree&filepath=packages%2Fmodels-library%2Fsrc%2Fmodels_library%2Fservices_metadata_editable.py&utm_medium=referral&utm_source=github&utm_content=comment&utm_campaign=pr+comments&utm_term=ITISFoundation#diff-cGFja2FnZXMvbW9kZWxzLWxpYnJhcnkvc3JjL21vZGVsc19saWJyYXJ5L3NlcnZpY2VzX21ldGFkYXRhX2VkaXRhYmxlLnB5) | `100.0% <ø> (ø)` | | | [.../src/models\_library/services\_metadata\_published.py](https://app.codecov.io/gh/ITISFoundation/osparc-simcore/pull/5969?src=pr&el=tree&filepath=packages%2Fmodels-library%2Fsrc%2Fmodels_library%2Fservices_metadata_published.py&utm_medium=referral&utm_source=github&utm_content=comment&utm_campaign=pr+comments&utm_term=ITISFoundation#diff-cGFja2FnZXMvbW9kZWxzLWxpYnJhcnkvc3JjL21vZGVsc19saWJyYXJ5L3NlcnZpY2VzX21ldGFkYXRhX3B1Ymxpc2hlZC5weQ==) | `100.0% <100.0%> (ø)` | | | [...src/simcore\_service\_webserver/catalog/\_handlers.py](https://app.codecov.io/gh/ITISFoundation/osparc-simcore/pull/5969?src=pr&el=tree&filepath=services%2Fweb%2Fserver%2Fsrc%2Fsimcore_service_webserver%2Fcatalog%2F_handlers.py&utm_medium=referral&utm_source=github&utm_content=comment&utm_campaign=pr+comments&utm_term=ITISFoundation#diff-c2VydmljZXMvd2ViL3NlcnZlci9zcmMvc2ltY29yZV9zZXJ2aWNlX3dlYnNlcnZlci9jYXRhbG9nL19oYW5kbGVycy5weQ==) | `76.0% <100.0%> (ø)` | | ... and [1148 files with indirect coverage changes](https://app.codecov.io/gh/ITISFoundation/osparc-simcore/pull/5969/indirect-changes?src=pr&el=tree-more&utm_medium=referral&utm_source=github&utm_content=comment&utm_campaign=pr+comments&utm_term=ITISFoundation)