From a4993e2d78fe0b1c60a57ff6df06bcbc30c9cd13 Mon Sep 17 00:00:00 2001 From: Andrei Molnar <1995am@pm.me> Date: Thu, 19 Nov 2026 10:19:28 +0100 Subject: [PATCH] Configuration dialog. + Help dialog --- .../molnarandrei/sopa/ui/ConfigDialog.java | 131 ++++++++++++++++++ .../com/molnarandrei/sopa/ui/HelpDialog.java | 96 +++++++++++++ .../molnarandrei/sopa/ui/menu/TopMenu.java | 12 ++ 3 files changed, 239 insertions(+) create mode 100644 src/main/java/com/molnarandrei/sopa/ui/ConfigDialog.java create mode 100644 src/main/java/com/molnarandrei/sopa/ui/HelpDialog.java diff --git a/src/main/java/com/molnarandrei/sopa/ui/ConfigDialog.java b/src/main/java/com/molnarandrei/sopa/ui/ConfigDialog.java new file mode 100644 index 0000000..992e729 --- /dev/null +++ b/src/main/java/com/molnarandrei/sopa/ui/ConfigDialog.java @@ -0,0 +1,131 @@ +package com.molnarandrei.sopa.ui; + +import atlantafx.base.controls.Spacer; +import atlantafx.base.theme.Styles; +import com.molnarandrei.sopa.data.yaml.Config; +import com.molnarandrei.sopa.ui.lib.Packing; +import javafx.geometry.Insets; +import javafx.scene.Scene; +import javafx.scene.control.*; +import javafx.scene.layout.*; +import javafx.stage.Modality; +import javafx.stage.Stage; +import javafx.stage.Window; +import org.kordamp.ikonli.javafx.FontIcon; +import org.kordamp.ikonli.materialdesign2.MaterialDesignC; + +import java.util.ArrayList; +import java.util.List; +import java.util.function.Consumer; +import java.util.function.Supplier; + +/** Edits the settings of the app; they are saved only with "Guardar cambios". */ +public class ConfigDialog extends Stage { + + /** A whole number setting, valid from {@code min}. */ + private record Setting(TextField field, int min, Consumer set) {} + + private final List settings = new ArrayList<>(); + private final GridPane grid = new GridPane(); + + public ConfigDialog(Window owner) { + initOwner(owner); + initModality(Modality.WINDOW_MODAL); + setTitle("Configuración"); + + var title = new Label("Configuración"); + Styles.addStyleClass(title, Styles.TITLE_1); + + grid.setVgap(8); + grid.setHgap(16); + var fieldColumn = new ColumnConstraints(); + fieldColumn.setHgrow(Priority.ALWAYS); + grid.getColumnConstraints().addAll(new ColumnConstraints(), fieldColumn); + + var config = Config.get(); + add("Historial de respuestas:", "Respuestas que se guardan por paso; al superarlas se borran las más antiguas.", + 1, config::getResponseHistory, config::setResponseHistory); + add("Tiempo de espera (s):", "Segundos que se espera a conectar con el servidor y a recibir su respuesta antes de dar la llamada por fallida.", + 1, config::getCallTimeout, config::setCallTimeout); + add("Cambios a deshacer:", "Eliminaciones y modificaciones que se pueden deshacer con Ctrl+Z; las más antiguas se olvidan.", + 1, config::getMaxUndo, config::setMaxUndo); + add("Agrupar ediciones (s):", "Las ediciones de un mismo fichero en estos segundos desde la primera se deshacen juntas. Con 0 se deshacen una a una.", + 0, config::getUndoMergeSeconds, config::setUndoMergeSeconds); + + var scroll = new ScrollPane(grid); + scroll.setFitToWidth(true); + scroll.setPadding(new Insets(4)); + + var cancel = new Button("Cancelar"); + cancel.setCancelButton(true); + cancel.setOnAction(e -> close()); + + var save = new Button("Guardar cambios", FontIcon.of(MaterialDesignC.CONTENT_SAVE)); + Styles.addStyleClass(save, Styles.ACCENT); + save.setDefaultButton(true); + save.setOnAction(e -> save()); + + var root = new BorderPane(); + root.setPadding(new Insets(16)); + root.setTop(title); + BorderPane.setMargin(title, new Insets(0, 0, 8, 0)); + root.setCenter(scroll); + root.setBottom(new VBox(8, new Separator(), new HBox(8, new Spacer(), cancel, save))); + BorderPane.setMargin(root.getBottom(), new Insets(8, 0, 0, 0)); + root.setPrefWidth(480); + + var scene = new Scene(root); + if (owner != null && owner.getScene() != null) + scene.getStylesheets().addAll(owner.getScene().getStylesheets()); + setScene(scene); + Packing.pack(this, scene); + } + + private void add(String name, String description, int min, Supplier get, Consumer set) { + var label = new Label(name); + var field = new TextField(String.valueOf(get.get())); + // Only digits can be typed. + field.setTextFormatter(new TextFormatter(change -> change.getControlNewText().matches("\\d*") ? change : null)); + field.textProperty().addListener((obs, old, value) -> field.pseudoClassStateChanged(Styles.STATE_DANGER, false)); + var tooltip = new Tooltip(description + (min > 0 ? " Mínimo %d.".formatted(min) : "")); + tooltip.setWrapText(true); + tooltip.setMaxWidth(360); + label.setTooltip(tooltip); + field.setTooltip(tooltip); + // Behind the label and the field, so the gaps of the row show the tooltip too. + var background = new Region(); + Tooltip.install(background, tooltip); + + var row = settings.size(); + grid.add(background, 0, row, 2, 1); + grid.add(label, 0, row); + grid.add(field, 1, row); + settings.add(new Setting(field, min, set)); + } + + /** Saves when every value is valid; else marks the invalid fields and keeps the dialog open. */ + private void save() { + var valid = true; + for (var setting : settings) { + var invalid = valueOf(setting) == null; + setting.field().pseudoClassStateChanged(Styles.STATE_DANGER, invalid); + valid &= ! invalid; + } + if (! valid) return; + + for (var setting : settings) + setting.set().accept(valueOf(setting)); + Config.get().save(); + close(); + } + + /** Null when blank, too big or below the minimum. */ + private static Integer valueOf(Setting setting) { + try { + var value = Integer.parseInt(setting.field().getText()); + return value < setting.min() ? null : value; + } catch (NumberFormatException blankOrTooBig) { + return null; + } + } +} diff --git a/src/main/java/com/molnarandrei/sopa/ui/HelpDialog.java b/src/main/java/com/molnarandrei/sopa/ui/HelpDialog.java new file mode 100644 index 0000000..43dd474 --- /dev/null +++ b/src/main/java/com/molnarandrei/sopa/ui/HelpDialog.java @@ -0,0 +1,96 @@ +package com.molnarandrei.sopa.ui; + +import atlantafx.base.controls.Spacer; +import atlantafx.base.theme.Styles; +import com.molnarandrei.sopa.ui.lib.Packing; +import javafx.geometry.Insets; +import javafx.scene.Scene; +import javafx.scene.control.*; +import javafx.scene.layout.*; +import javafx.stage.Modality; +import javafx.stage.Stage; +import javafx.stage.Window; + +public class HelpDialog extends Stage { + private static final String[][] SHORTCUTS = { + {"Ctrl+N", "Crea dentro de lo seleccionado en el árbol: un caso en un proyecto, un paso en un caso o en el caso de un paso. Sin selección, un proyecto."}, + {"Ctrl+S", "Guarda el editor o las propiedades abiertas."}, + {"Enter", "Guarda el campo."}, + {"Ctrl+Z", "En el árbol, deshace la última eliminación o modificación. Cada campo se guarda al salir de él, así que cada cambio se puede deshacer; las ediciones de un mismo fichero en 10 s (por defecto, en Configuración) se deshacen juntas."}, + {"Ctrl+C / X / V", "En el árbol, copia, corta y pega casos y pasos."}, + {"Supr", "En el árbol, elimina lo seleccionado."}, + {"Tab / Mayús+Tab", "En el XML, sangra o quita la sangría."}, + }; + + public HelpDialog(Window owner) { + initOwner(owner); + initModality(Modality.WINDOW_MODAL); + setTitle("Ayuda"); + + var shortcuts = new GridPane(); + shortcuts.setHgap(16); + shortcuts.setVgap(8); + var descriptionColumn = new ColumnConstraints(); + descriptionColumn.setHgrow(Priority.ALWAYS); + // The keys keep their width, the descriptions wrap in the rest. + var keysColumn = new ColumnConstraints(); + keysColumn.setMinWidth(Region.USE_PREF_SIZE); + shortcuts.getColumnConstraints().addAll(keysColumn, descriptionColumn); + for (int row = 0; row < SHORTCUTS.length; row++) { + var keys = new Label(SHORTCUTS[row][0]); + Styles.addStyleClass(keys, Styles.TEXT_BOLD); + keys.setMinWidth(Region.USE_PREF_SIZE); + shortcuts.add(keys, 0, row); + shortcuts.add(text(SHORTCUTS[row][1]), 1, row); + } + + var content = new VBox(8, + title("Sopa", Styles.TITLE_1), + text("Sopa prueba servicios SOAP. Un proyecto tiene casos de prueba y cada caso, pasos: llamadas SOAP con " + + "aserciones y extracciones que guardan propiedades para los pasos siguientes. Ejecutar un caso o un " + + "proyecto ejecuta sus pasos en orden y se detiene en el primero que falla."), + title("Pensada para agentes", Styles.TITLE_3), + text("Un proyecto son ficheros YAML y .properties legibles en su carpeta, descritos en su AGENTS.md. Tú o un " + + "agente IA podéis editarlos desde fuera y la app los recarga al momento; lo que cambias en la app se " + + "escribe en ellos."), + title("Atajos", Styles.TITLE_3), + shortcuts + ); + content.setPadding(new Insets(4)); + + var scroll = new ScrollPane(content); + scroll.setFitToWidth(true); + + var close = new Button("Cerrar"); + close.setDefaultButton(true); + close.setCancelButton(true); + close.setOnAction(e -> close()); + + var root = new BorderPane(); + root.setPadding(new Insets(16)); + root.setCenter(scroll); + root.setBottom(new VBox(8, new Separator(), new HBox(new Spacer(), close))); + BorderPane.setMargin(root.getBottom(), new Insets(8, 0, 0, 0)); + root.setPrefSize(560, 520); + + var scene = new Scene(root); + if (owner != null && owner.getScene() != null) + scene.getStylesheets().addAll(owner.getScene().getStylesheets()); + setScene(scene); + Packing.pack(this, scene); + } + + private static Label title(String text, String style) { + var label = new Label(text); + Styles.addStyleClass(label, style); + return label; + } + + private static Label text(String text) { + var label = new Label(text); + label.setWrapText(true); + // Else layouts give it the height of one line and it shows as "...". + label.setMinHeight(Region.USE_PREF_SIZE); + return label; + } +} diff --git a/src/main/java/com/molnarandrei/sopa/ui/menu/TopMenu.java b/src/main/java/com/molnarandrei/sopa/ui/menu/TopMenu.java index 334ab26..285f65b 100644 --- a/src/main/java/com/molnarandrei/sopa/ui/menu/TopMenu.java +++ b/src/main/java/com/molnarandrei/sopa/ui/menu/TopMenu.java @@ -5,6 +5,8 @@ import com.molnarandrei.sopa.data.yaml.Config; import com.molnarandrei.sopa.data.yaml.Kind; import com.molnarandrei.sopa.events.Events; import com.molnarandrei.sopa.events.ProjectTreeViewEvent; +import com.molnarandrei.sopa.ui.ConfigDialog; +import com.molnarandrei.sopa.ui.HelpDialog; import com.molnarandrei.sopa.ui.PropertiesDialog; import com.molnarandrei.sopa.ui.create.CreateProjectDialog; import javafx.event.EventHandler; @@ -17,8 +19,10 @@ import com.molnarandrei.sopa.project.ProjectService; import javafx.scene.control.*; import javafx.stage.*; import org.kordamp.ikonli.javafx.FontIcon; +import org.kordamp.ikonli.materialdesign2.MaterialDesignA; import org.kordamp.ikonli.materialdesign2.MaterialDesignC; import org.kordamp.ikonli.materialdesign2.MaterialDesignF; +import org.kordamp.ikonli.materialdesign2.MaterialDesignH; import java.nio.file.Path; import java.util.HashMap; @@ -70,12 +74,20 @@ public class TopMenu extends MenuBar { propertiesMenu = new Menu(); propertiesMenu.setGraphic(propertiesLabel); + var config = new MenuItem("Configuración", FontIcon.of(MaterialDesignC.COG)); + config.setOnAction(e -> new ConfigDialog(getScene().getWindow()).show()); + var help = new MenuItem("Ayuda", FontIcon.of(MaterialDesignH.HELP_CIRCLE_OUTLINE)); + help.setOnAction(e -> new HelpDialog(getScene().getWindow()).show()); + var appMenu = new Menu("Aplicación", FontIcon.of(MaterialDesignA.APPLICATION_COG)); + appMenu.getItems().addAll(config, help); + // MenuBar only holds Menus, so the spacer is an empty, disabled Menu whose button grows (see layoutChildren). separatorMenu = new Menu(); separatorMenu.setDisable(true); getMenus().addAll( projectMenu, + appMenu, separatorMenu, propertiesMenu );