`simvx.editor.duplicate_node_dialog`¶

Duplicate Node dialog — three semantically distinct duplication variants.

Opened from the Scene Tree right-click menu (or programmatically) for the currently-selected node. The user picks one of:

New Instance — parent gains another add_child(<SameClass>(...)) call with the same property kwargs as the original. No source file is created.
Subclass — prompts for a class name (default <Original>2), creates <class_files_dir>/<snake_case_name>.py with class <Name>(<Original>): pass, then adds an instance of the new class under the parent. For built-in originals the new file’s base is the built-in class itself — the same mechanism with no special-casing.
Detached Copy — prompts for a class name, creates a new file with class <Name>(<OriginalBaseClass>): <body> where <body> is copied verbatim from the original class definition (parsed via

func:

simvx.core.scene_io.parse_source) but rebased on the original’s own base class — not on the original class itself. For built-in originals (no class file to copy from) this degenerates to a pass-bodied file, identical to Subclass.

The dialog blocks submit when the chosen class name collides with any class already known to :class:~simvx.editor.project_classes.ProjectClassIndex.

The dialog is decoupled from the panel that hosts it — it does not depend on :class:~simvx.editor.panels.scene_tree.panel.SceneTreePanel and can be opened from a context menu, command palette, or test harness directly. The caller wires :attr:submitted to receive the new live :class:~simvx.core.Node.

Module Contents¶

Classes¶

DuplicateNodeDialog

Modal Duplicate Node dialog hosting the three duplication variants.

Data¶

`log`
`__all__`
`DUPLICATE_VARIANTS`

API¶

simvx.editor.duplicate_node_dialog.log¶: ‘getLogger(…)’

simvx.editor.duplicate_node_dialog.__all__¶: [‘DUPLICATE_VARIANTS’, ‘DuplicateNodeDialog’]

simvx.editor.duplicate_node_dialog.DUPLICATE_VARIANTS¶: (‘instance’, ‘subclass’, ‘detached’)

class simvx.editor.duplicate_node_dialog.DuplicateNodeDialog(**kwargs)[source]¶

Bases: simvx.core.Panel

Modal Duplicate Node dialog hosting the three duplication variants.

Lifecycle: dialog = DuplicateNodeDialog() dialog.submitted.connect(handler) dialog.show_for(node, project_index=index, project_path=path)

The handler receives the newly-created Node instance (already parented to node.parent). When the variant creates a file, the file is written to disk before submitted fires.

Initialization

DIALOG_W¶: 480.0

DIALOG_H¶: 320.0

show_for(node: simvx.core.Node, *, project_index: simvx.editor.project_classes.ProjectClassIndex | None = None, project_path: pathlib.Path | None = None, class_files_dir: str = 'src') → None[source]¶

Open the dialog for node.

project_index drives collision detection and is also used to determine whether the original is user-defined (so Detached Copy knows where to read the class body from). project_path and class_files_dir resolve the destination directory for newly generated files; the dialog refuses to submit a Subclass / Detached Copy when project_path is unset.