[NEAT-734] 👮 Experiment idempotent

[doctrino]

Description

Basic idea for how to implement a lock down of the neat session such that the user cannot call the 'wrong' methods. Instead get an appropriate error message.

I think the way to do this is to change the SessionState into something like the following. In other words, control all changes to the state through a change method that validates that you can do the change. For example, you can only import a data model, if you do not already have a data model. Furthermore, all export/load/read is also exposed so we can use that, but we are not allowed to change the state through any other method than change.

class ReadQueriesAPI:
    def list_types(self) -> list[str]:
        ...

class SessionState:
    def __init__(self, client: NeatClient):
        self.instances = ReadQueriesAPI()

    def change(self, action: Action, description: str | None) -> IssueList:
        ...
    
    def export(self, exporter: BaseExporter[T_Export]) -> T_Export:
        ...

    def export_to_file(self, exporter: BaseExporter, path: Path) -> None:
        ...

    def export_to_cdf(self, exporter: CDFExporter, client: NeatClient, dry_run: bool) -> UploadResultList:
        ...
    
    def load(self, loader: BaseLoader) -> UploadResultList:
        ...

Bump

• Patch
• Minor
• Skip

Changelog

Changed/Improved

• All methods in the NeatSession are now strictly validated.

[github-actions]

☂️ Python Coverage

current status: ✅

Overall Coverage

Lines	Covered	Coverage	Threshold	Status
15032	12022	80%	60%	🟢

New Files

File	Coverage	Status
cognite/neat/_store/_manager.py	50%	🟢
TOTAL	50%	🟢

Modified Files

File	Coverage	Status
cognite/neat/_graph/transformers/init.py	100%	🟢
cognite/neat/_session/_read.py	72%	🟢
cognite/neat/_session/_state.py	78%	🟢
cognite/neat/_store/init.py	100%	🟢
cognite/neat/_store/exceptions.py	68%	🟢
TOTAL	84%	🟢

updated for commit: 20144f7 by action🐍