Add classes MethodWithArgs, SceneInteractContinue and SceneInteractRerun inside new module manim.data_structures

[chopan050]

Overview: What does this pull request change?

• Add classes MethodWithArgs, SceneInteractContinue and SceneInteractRerun. Currently, they all exist inside a new manim.data_structures file, although I intend to move SceneInteractContinue and SceneInteractRerun into scene.py if PR Move configure_pygui into a Scene method and remove manim.gui #4314 is merged first.
• Make the items of Scene.queue, _AnimationBuilder.methods and _MethodAnimation.methods objects of these classes instead of tuples.

Motivation and Explanation: Why and how do your changes improve the library?

Scene.queue, _AnimationBuilder.methods and _MethodAnimation.methods contain tuples where the first element represents a method to be called, the second one is its args and the third one is its kwargs. Moreover, in the case of Scene.queue, the first element (a string) might not necessarily represent a method: it can be a key starting with "rerun" (in which case the args are not used and only some key-value pairs are extracted from the kwargs) or with "exit" (in which case neither the args nor the kwargs are used). On first sight, this might be very confusing. Previously, there were no docs for this behavior and I asked for them to be added in a comment I made while reviewing PR #4260. Now, I believe that it would be better if those were different objects from different classes altogether.

Links to added or changed documentation pages

I added data_structures.py to utilities_misc.rst, so now you can see the new MethodWithArgs structure in:
https://manimce--4315.org.readthedocs.build/en/4315/reference/manim.data_structures.html

The SceneInteractContinue and SceneInteractRerun classes are defined in:
https://manimce--4315.org.readthedocs.build/en/4315/reference/manim.scene.scene.html

The SceneInteractAction type alias was previously defined there as well. However, its docstring is not showing. Presumably, it's because it's indented inside the if TYPE_CHECKING: clause. It works fine when it's unindented.

Further Information and Comments

Reviewer Checklist

• The PR title is descriptive enough for the changelog, and the PR is labeled correctly
• If applicable: newly added non-private functions and classes have a docstring including a short summary and a PARAMETERS section
• If applicable: newly added functions and classes are tested

[chopan050]

Note: it seems only "from_animation_number" from SceneInteractRerun.kwargs is being used. The other kwargs are unused. Thus, the structure could be simplified to directly contain an attribute .from_animation_number instead of .kwargs, but this requires discussion.

[behackl]

This seems like a fine improvement and cleanup -- could you please just resolve the conflict / move the things you wanted to move first and then let me know (just re-request a review or ping me on Discord).

[chopan050]

This seems like a fine improvement and cleanup -- could you please just resolve the conflict / move the things you wanted to move first and then let me know (just re-request a review or ping me on Discord).

I just did, and I also added the data_structures.py file to docs/source/reference_index/utilities_misc.rst in order to render its docs in the website.

Note: the docstring of SceneInteractAction type alias, previously defined in scene.py, is not showing. Presumably, it's because the alias is indented inside the if TYPE_CHECKING: clause. It works fine when it's unindented. It can probably be fixed in a subsequent PR by modifying module_parsing.py.