Add `CamerasTable` to `SessionsDock`

[roomrys]

Description

The overall goal is to add Camcorder/Video assignment table to the SessionsDock that is linked to the SessionsTable created above. This CamerasTable will have two columns. One column will display the Camcorder.names of all Camcorders in the RecordingSession.cameras: List[Camcorder] list. The second column will show which Videos are assigned to the adjacent Camcorder.name by displaying the returned value of RecordingSession.get_video(Camcorder) (or "" if None).

• [x] Subclass GenericTableModel to create a new model called CamerasTableModel with properties = ("camera", "video")
• [x] Implement the method CamerasTableModel.object_to_items(self, obj: RecordingSession) which returns the list of Camcorders in obj.cameras: List[Camcorder]
• [x] Implement the method CamerasTableModel.item_to_data(self, obj: RecordingSession, item: Camcorder) which returns the following dictionary: {camera: item.name, video: obj.get_video(item)}
• [x] Add a cameras_model_type = CamerasTableModel attribute to SessionsDock (similar to SkeletonDock.nodes_model_type) and pass into the model_type list for super().__init__
• [x] Add a SessionsDock.create_models method (or append to it if it already exists) that sets a SessionsDock.cameras_model = SessionsDock.sessions_model_type(items=main_window.state["selected_session"], context=main_window.commands) and returns a list of all models created (see SkeletonDock.create_models)
• [x] Add a SessionsDock.create_tables method (or append to it if it already exists) that sets a SessionsDock.cameras_table = GenericTableView(state=..., row_name="camera", ...) and returns a list of all tables created (see SkeletonDock.create_tables)
• [x] Add a command class and CommandContext.unlink_video_from_camera method to un-link a Video from a Camcorder
• [x] Add a button to "Unlink Video" and connect it to the CommandContext.unlink_video_from_camera method
• [x] Disable button to "Unlink Video" when there is no selected Camcorder for the CamerasTable
• [x] In the SessionsDock.lay_everything_out method, add the SessionsDock.cameras_table to the SessionsDock.wgt_layout: QVBoxLayout (see the InstancesDock.lay_everything_out).
• [x] Add a sessions option to UpdateTopic: Enum if not already there
• [x] In MainWindow.on_data_update add (or append to) the if _has_topic(UpdateTopic.sessions) that updates the items to display in the CamerasTable (see video_dock.table update)
• [ ] Set the GuiState for the "session" key to the first RecordingSession in labels.sessions: List[RecordingSession] when loading a Labels project (similar to how we set the state for "video")

Test the CamerasTable

Tests for the CamerasTable will be added to tests/gui/test_dataviews.py. These tests will only test the functionality of the table as it's own entity.

• [x] Test that the expected Camcorder is returned when we select a specific row of the table (see existing test for inspiration)
• [x] Test that when we update a Camcorder in labels.sessions, the Camcorder in the table is updated as well (i.e. if we unlink a Video from a Camcorder, the data in the Video cell should be empty)

Test the CamerasTable as part of the SessionsDock

Tests for the SessionsDock will be added to tests/gui/widgets/test_docks.py.

• [x] Test interactions with table and GuiState (see existing test)

**Fig 1**: Depiction of Cameras Table layout. ### Types of changes - [ ] Bugfix - [x] New feature - [ ] Refactor / Code style update (no logical changes) - [ ] Build / CI changes - [ ] Documentation Update - [ ] Other (explain) ### Does this address any currently open issues? [list open issues here] ### Outside contributors checklist - [ ] Review the [guidelines for contributing](https://github.com/talmolab/sleap/blob/develop/docs/CONTRIBUTING.md) to this repository - [ ] Read and sign the [CLA](https://github.com/talmolab/sleap/blob/develop/sleap-cla.pdf) and add yourself to the [authors list](https://github.com/talmolab/sleap/blob/develop/AUTHORS) - [ ] Make sure you are making a pull request against the **develop** branch (not *main*). Also you should start *your branch* off *develop* - [ ] Add tests that prove your fix is effective or that your feature works - [ ] Add necessary documentation (if appropriate) #### Thank you for contributing to SLEAP! :heart: ## Summary by CodeRabbit - **New Features** - Introduced session management in the GUI, including state initialization and updates. - Added functionality to unlink videos from cameras within sessions. - Implemented a new `CamerasTableModel` for managing camera and video pairs in recording sessions. - Enhanced `SessionsDock` with new methods and attributes to support camera management and video unlinking. - **Tests** - Updated and added tests for GUI data views and `SessionsDock` functionality, including camera table presentation and video unlinking.

[coderabbitai[bot]]

Walkthrough

The recent updates focus on enhancing the user interface and functionality of a GUI application, specifically by improving session management and camera-video linkage. New features include the ability to unlink videos from cameras, better handling of camera selections in the GUI, and updates to data views and widgets to support these changes. The modifications span across app initialization, command actions, and GUI components, aiming to provide a more intuitive and flexible user experience.

Changes

Files	Change Summary
sleap/gui/app.py	Added session state, selected_camera handling, button enablement, and updated session handling
sleap/gui/commands.py	Introduced method to unlink video from camera; updated do_action for session handling
sleap/gui/dataviews.py	Added Camcorder, RecordingSession imports; new CamerasTableModel class
sleap/gui/widgets/docks.py	Updated with CamerasTableModel, new methods for model and table creation, video unlink button
tests/gui/test_dataviews.py tests/gui/widgets/test_docks.py	Enhanced tests for camera table functionality, SessionsDock, and camera unlinking

Poem

In the land of code, where the bits do hop,
A rabbit worked, with no intent to stop. 🐇💻
"Let cameras unlink, let sessions flow,"
It said with a wink, making the GUI glow.
With every push and pull, it danced with glee,
"For a more intuitive GUI, trust in me!"

Thank you for using CodeRabbit. We offer it for free to the OSS community and would appreciate your support in helping us grow. If you find it useful, would you consider giving us a shout-out on your favorite social media?

Share

- [X](https://twitter.com/intent/tweet?text=I%20just%20used%20%40coderabbitai%20for%20my%20code%20review%2C%20and%20it%27s%20fantastic%21%20It%27s%20free%20for%20OSS%20and%20offers%20a%20free%20trial%20for%20the%20proprietary%20code.%20Check%20it%20out%3A&url=https%3A//coderabbit.ai) - [Mastodon](https://mastodon.social/share?text=I%20just%20used%20%40coderabbitai%20for%20my%20code%20review%2C%20and%20it%27s%20fantastic%21%20It%27s%20free%20for%20OSS%20and%20offers%20a%20free%20trial%20for%20the%20proprietary%20code.%20Check%20it%20out%3A%20https%3A%2F%2Fcoderabbit.ai) - [Reddit](https://www.reddit.com/submit?title=Great%20tool%20for%20code%20review%20-%20CodeRabbit&text=I%20just%20used%20CodeRabbit%20for%20my%20code%20review%2C%20and%20it%27s%20fantastic%21%20It%27s%20free%20for%20OSS%20and%20offers%20a%20free%20trial%20for%20proprietary%20code.%20Check%20it%20out%3A%20https%3A//coderabbit.ai) - [LinkedIn](https://www.linkedin.com/sharing/share-offsite/?url=https%3A%2F%2Fcoderabbit.ai&mini=true&title=Great%20tool%20for%20code%20review%20-%20CodeRabbit&summary=I%20just%20used%20CodeRabbit%20for%20my%20code%20review%2C%20and%20it%27s%20fantastic%21%20It%27s%20free%20for%20OSS%20and%20offers%20a%20free%20trial%20for%20proprietary%20code)

---

Tips

### Chat There are 3 ways to chat with CodeRabbit: - Review comments: Directly reply to a review comment made by CodeRabbit. Example: - `I pushed a fix in commit .` - `Generate unit-tests for this file.` - `Open a follow-up GitHub issue for this discussion.` - Files and specific lines of code (under the "Files changed" tab): Tag `@coderabbitai` in a new review comment at the desired location with your query. Examples: - `@coderabbitai generate unit tests for this file.` - `@coderabbitai modularize this function.` - PR comments: Tag `@coderabbitai` in a new PR comment to ask questions about the PR branch. For the best results, please provide a very specific query, as very limited context is provided in this mode. Examples: - `@coderabbitai generate interesting stats about this repository and render them as a table.` - `@coderabbitai show all the console.log statements in this repository.` - `@coderabbitai read src/utils.ts and generate unit tests.` - `@coderabbitai read the files in the src/scheduler package and generate a class diagram using mermaid and a README in the markdown format.` Note: Be mindful of the bot's finite context window. It's strongly recommended to break down tasks such as reading entire modules into smaller chunks. For a focused discussion, use review comments to chat about specific files and their changes, instead of using the PR comments. ### CodeRabbit Commands (invoked as PR comments) - `@coderabbitai pause` to pause the reviews on a PR. - `@coderabbitai resume` to resume the paused reviews. - `@coderabbitai review` to trigger a review. This is useful when automatic reviews are disabled for the repository. - `@coderabbitai resolve` resolve all the CodeRabbit review comments. - `@coderabbitai help` to get help. Additionally, you can add `@coderabbitai ignore` anywhere in the PR description to prevent this PR from being reviewed. ### CodeRabbit Configration File (`.coderabbit.yaml`) - You can programmatically configure CodeRabbit by adding a `.coderabbit.yaml` file to the root of your repository. - The JSON schema for the configuration file is available [here](https://coderabbit.ai/integrations/coderabbit-overrides.v2.json). - If your editor has YAML language server enabled, you can add the path at the top of this file to enable auto-completion and validation: `# yaml-language-server: $schema=https://coderabbit.ai/integrations/coderabbit-overrides.v2.json` ### CodeRabbit Discord Community Join our [Discord Community](https://discord.com/invite/GsXnASn26c) to get help, request features, and share feedback.

[roomrys]

• [x] Cameras Table is displayed on opening GUI

• [ ] Cameras Table should be updated based on the GUIState "sessions"

[roomrys]

• [x] Cameras Table automatically loads

  

• [x] Unlink video button works