Use model with libraries

[redeexpressos]

Hello.

The current implementation does not support models with libraries. When launching the docker container, I get the following errors:

at=INFO logger=capella_model_explorer.app msg="Loading model from: /model"
at=ERROR logger=uvicorn.error msg="Traceback (most recent call last):\n  File \"/app/lib/python3.12/site-packages/starlette/routing.py\", line 694, in lifespan\n    async with self.lifespan_context(app) as maybe_state:\n               ^^^^^^^^^^^^^^^^^^^^^^^^^^\n  File \"/usr/local/lib/python3.12/contextlib.py\", line 210, in __aenter__\n    return await anext(self.gen)\n           ^^^^^^^^^^^^^^^^^^^^^\n  File \"/app/lib/python3.12/site-packages/capella_model_explorer/app.py\", line 40, in lifespan\n    state.model = capellambse.MelodyModel(**model_spec)\n                  ^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^\n  File \"/app/lib/python3.12/site-packages/capellambse/model/_model.py\", line 289, in __init__\n    self._loader = loader.MelodyLoader(path, **kwargs)\n                   ^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^\n  File \"/app/lib/python3.12/site-packages/capellambse/loader/core.py\", line 561, in __init__\n    self.__load_referenced_files(\n  File \"/app/lib/python3.12/site-packages/capellambse/loader/core.py\", line 621, in __load_referenced_files\n    self.__load_referenced_files(ref_name)\n  File \"/app/lib/python3.12/site-packages/capellambse/loader/core.py\", line 611, in __load_referenced_files\n    handler = self.resources[resource_path.parts[0]]\n              ~~~~~~~~~~~~~~^^^^^^^^^^^^^^^^^^^^^^^^\n  File \"/app/lib/python3.12/site-packages/capellambse/loader/core.py\", line 186, in __missing__\n    raise MissingResourceLocationError(key)\ncapellambse.loader.core.MissingResourceLocationError: 'My Library'\n"
at=ERROR logger=uvicorn.error msg="Application startup failed. Exiting."
^Cat=INFO logger=uvicorn.error msg="Stopping reloader process [1]"

When working with py-capellambse, I fix this by loading a "resources" path when creating the MelodyModel. However, in capella-model-explorer, the settings don't support it.

Is there a solution for this?

[Wuestengecko]

Hi!

This is not yet possible using the cme run command. However, when launching the container manually, you can mount both the model and the library into the container, then specify a JSON-encoded dictionary to point to them, like this:

docker run --rm -it \
  -v "/path/to/my-model:/model/main" \
  -v "/path/to/my-library:/model/library" \
  -e CME_MODEL='{"path": "/model/main", "resources": {"My Library": "/model/library"}}' \
  ghcr.io/dsd-dbs/capella-model-explorer/model-explorer:master

I'm keeping this open to remind us to add a more convenient way to specify this to cme run.