core.gui.deletion_options¶
- class core.gui.deletion_options.DeletionOptions¶
Present the user with deletion options before proceeding.
When the user activates “Send to trash”, we present him with a couple of options that changes the behavior of that deletion operation.
- show(mark_count)¶
Prompt the user with a modal dialog offering our deletion options.
- Parameters
mark_count (int) – Number of dupes marked for deletion.
- Return type
bool
- Returns
Whether the user accepted the dialog (we cancel deletion if false).
- supports_links()¶
Returns whether our platform supports symlinks.
- direct¶
Delete dupes directly and don’t send to trash. bool. get/set
- property link_deleted¶
Replace deleted dupes with symlinks (or hardlinks) to the dupe group reference.
bool. get/set
Whether the link is a symlink or hardlink is decided by
use_hardlinks
.
- use_hardlinks¶
Whether symlinks or hardlinks are used when doing
link_deleted
. bool. get/set
- class core.gui.deletion_options.DeletionOptionsView¶
Expected interface for
DeletionOptions
’s view.Not actually used in the code. For documentation purposes only.
Our view presents the user with an appropriate way (probably a mix of checkboxes and radio buttons) to set the different flags in
DeletionOptions
. Note thatDeletionOptions.use_hardlinks
is only relevant ifDeletionOptions.link_deleted
is true. This is why we toggle the “enabled” state of that flag.We expect the view to set
DeletionOptions.link_deleted
immediately as the user changes its value because it will toggleset_hardlink_option_enabled()
Other than the flags, there’s also a prompt message which has a dynamic content, defined by
update_msg()
.- set_hardlink_option_enabled(is_enabled: bool)¶
Enable or disable the widget controlling
DeletionOptions.use_hardlinks
.
- show()¶
Show the dialog in a modal fashion.
Returns whether the dialog was “accepted” (the user pressed OK).
- update_msg(msg: str)¶
Update the dialog’s prompt with
str
.