F entity role

Summary

Fixes unintuitive behavior of "Entity.role" after a retrieval.

(As per the bug report in the CaosDB matrix chat)

1. When an entity is retrieved with a class (i.e. a subtype of Entity) which does not match the entity role, an exception is being raised.
2. When an entity is retrieved using the Entity class, the correct role is set and available via Entity.role

Focus

The only real changes are in models.py. See the annotations for more info.

Everything else is just new tests covering the changes.

Test Environment

• No manual testing necessary.
• See unit tests in this MR
• See integration tests in caosdb-pyinttest!19 (merged)

Check List for the Author

• All automated tests pass
• Reference related Issues
• Up-to-date CHANGELOG.md
• Annotations in code (Gitlab comments)
  • Intent of new code
  • Problems with old code
  • Why this implementation?

Check List for the Reviewer

• I understand the intent of this MR
• All automated tests pass
• Up-to-date CHANGELOG.md
• The test environment setup works and the intended behavior is reproducible in the test environment
• In-code documentation and comments are up-to-date.
• Check: Are there spezifications? Are they satisfied?
• remove xfail from pyint test (line 587; test_misc.py): @mark.xfail(reason="Waits for MR https://gitlab.indiscale.com/caosdb/src/caosdb-pylib/-/merge_requests/15")

For further good practices have a look at our review guidelines.

changed the description

changed target branch from main to dev

assigned to @timm

added 3 commits

• aa7ca267 - FIX Entity.retrieve(id) such that the entity has the correct role
• 958944e2 - EHN: add "role" property to QueryTemplate
• de87a469 - DOC: update CHANGELOG

Compare with previous version

mentioned in merge request caosdb-pyinttest!11 (merged)

added 1 commit

• 86199769 - remove unused code

Compare with previous version

changed the description

marked the checklist item Annotations in code (Gitlab comments) as completed

marked the checklist item Up-to-date CHANGELOG.md as completed

marked the checklist item Reference related Issues as completed

requested review from @salexan

marked the checklist item I understand the intent of this MR as completed