SPB Git

Repository Public License

UnitTests.swift 11.8 KB 203 lines swift

1// ORIX OS Automation2// File: Packages/ORIXFeatureWorkflow/Tests/ORIXFeatureWorkflowTests/UnitTests.swift3// Description: Unit tests of the studio's pure logic: argument form conversion, canvas geometry, viewport maths, keyboard navigation, trigger previews and parameter forms.4//5// Author: Simon-Pierre Boucher6// Contact: contact@spboucher.ai7import CoreGraphics8import Foundation9import ORIXAppUI10import Testing11@testable import ORIXFeatureWorkflow1213@Suite("Unit · argument form") struct ArgumentFormTests {14    static let schema = JSONSchema.object([15        "path": .string("Where"), "limit": .integer("How many", minimum: 1, maximum: 50), "ratio": .number("Share"),16        "overwrite": .boolean("Replace"), "mode": .string("How", enum: ["create", "append"]), "tags": .array(of: .string(), "Labels"),17        "counts": .array(of: .integer()), "options": JSONSchema(raw: ["type": "object"]),18    ], required: ["path", "limit"])1920    func field(_ name: String) -> SchemaField { ArgumentForm.fields(of: Self.schema).first { $0.name == name }! }2122    @Test func fieldsAreTypedAndRequiredOnesComeFirst() {23        let fields = ArgumentForm.fields(of: Self.schema)24        #expect(fields.prefix(2).map(\.name) == ["limit", "path"])25        #expect(field("mode").kind == .enumeration(["create", "append"]))26        #expect(field("tags").kind == .array && field("overwrite").kind == .boolean && field("ratio").kind == .number)27    }2829    @Test func textRoundTripsThroughEveryFieldKind() throws {30        let cases: [(String, String, JSONValue)] = [31            ("path", "~/Reports/out.md", .string("~/Reports/out.md")), ("limit", "12", .int(12)), ("ratio", "0.25", .number(0.25)), ("ratio", "3", .int(3)),32            ("overwrite", "true", .bool(true)), ("mode", "append", .string("append")), ("tags", "a\nb", .array(["a", "b"])), ("counts", "[1,2]", .array([1, 2])),33            ("options", "{\"k\":1}", .object(["k": 1])),34        ]35        for (name, text, expected) in cases {36            let parsed = try ArgumentForm.parse(text, field: field(name)).get()37            #expect(parsed == expected, "\(name)")38            // Text shown for the stored value parses back to the same value.39            #expect(try ArgumentForm.parse(ArgumentForm.text(for: parsed), field: field(name)).get() == expected, "\(name) round trip")40        }41    }4243    @Test func expressionsAreAcceptedInEveryFieldAndKeptAsText() throws {44        for name in ["path", "limit", "ratio", "overwrite", "mode", "tags", "options"] {45            #expect(try ArgumentForm.parse("${{ params.x }}", field: field(name)).get() == .string("${{ params.x }}"))46        }47    }4849    @Test func invalidLiteralsAreRefusedWithAMessage() {50        func message(_ name: String, _ text: String) -> String? { if case .failure(let e) = ArgumentForm.parse(text, field: field(name)) { return e.message }; return nil }51        #expect(message("limit", "many") != nil)52        #expect(message("limit", "99") != nil)       // above the schema maximum53        #expect(message("ratio", "x") != nil)54        #expect(message("overwrite", "maybe") != nil)55        #expect(message("mode", "delete") != nil)    // not one of the choices56        #expect(message("counts", "1, two") != nil)57        #expect(message("options", "[1]") != nil)58        #expect(message("path", "ok") == nil)59    }6061    @Test func emptyTextMeansNotSet() throws {62        #expect(try ArgumentForm.parse("  ", field: field("ratio")).get() == nil)63    }6465    @Test func stubsSatisfyRequiredArguments() {66        let manifest = ToolManifest(identifier: "t.x", name: "X", summary: "", family: "t", inputSchema: Self.schema, sideEffect: .read, defaultTier: .readOnly)67        let stub = ArgumentForm.stub(for: manifest)68        #expect(Set(stub.keys) == ["path", "limit"])69        #expect(stub["limit"] == .int(1))            // the schema minimum, not 070        #expect(Self.schema.validate(.object(stub)).isEmpty)71    }7273    @Test func looseValuesKeepJSONTypes() {74        #expect(ArgumentForm.parseLoose("42") == .int(42))75        #expect(ArgumentForm.parseLoose("true") == .bool(true))76        #expect(ArgumentForm.parseLoose("[1, 2]") == .array([1, 2]))77        #expect(ArgumentForm.parseLoose("hello world") == .string("hello world"))78        #expect(ArgumentForm.parseLoose("${{ 1 + 1 }}") == .string("${{ 1 + 1 }}"))79    }80}8182@Suite("Unit · canvas geometry and navigation") struct CanvasGeometryTests {83    static func document() -> WorkflowDocument {84        WorkflowDocument(metadata: WorkflowMetadata(id: "g", name: "G"), spec: WorkflowSpec(triggers: [.manual], steps: [85            WorkflowStep(id: "a", kind: .set(SetStep(values: ["x": 1]))),86            WorkflowStep(id: "b", needs: ["a"], kind: .transform(TransformStep(expression: "${{ 1 }}"))),87            WorkflowStep(id: "c", needs: ["a"], kind: .transform(TransformStep(expression: "${{ 2 }}"))),88            WorkflowStep(id: "each", needs: ["b"], kind: .foreach(ForeachStep(items: .array([1, 2]), steps: [89                WorkflowStep(id: "inner", kind: .set(SetStep(values: ["y": 2]))),90            ]))),91        ]))92    }9394    @Test func nestedFramesAreAbsoluteAndInsideTheirContainer() {95        let graph = WorkflowGraph(document: Self.document())96        let g = CanvasGeometry(graph: graph)97        let container = g.frames["each"]!, inner = g.frames["inner"]!98        #expect(container.contains(inner))99        #expect(g.parents["inner"] == "each")100        #expect(g.order.firstIndex(of: "each")! < g.order.firstIndex(of: "inner")!)101        #expect(g.node(at: CGPoint(x: inner.midX, y: inner.midY)) == "inner")102        #expect(g.node(at: CGPoint(x: container.minX + 4, y: container.minY + 4)) == "each")103        #expect(g.bounds.contains(container))104    }105106    @Test func draggingAContainerMovesItsChildren() {107        let g = CanvasGeometry(graph: WorkflowGraph(document: Self.document()))108        let moved = g.frame("inner", dragging: ["each"], by: CGSize(width: 40, height: 20))!109        #expect(moved.minX == g.frames["inner"]!.minX + 40 && moved.minY == g.frames["inner"]!.minY + 20)110        #expect(g.frame("a", dragging: ["each"], by: CGSize(width: 40, height: 20)) == g.frames["a"])111    }112113    @Test func edgesAndPortsCanBeHit() {114        let graph = WorkflowGraph(document: Self.document())115        let g = CanvasGeometry(graph: graph)116        let edge = graph.edges.first { $0.from == "a" && $0.to == "b" }!117        let curve = g.curve(for: edge)!118        #expect(g.edge(at: curve.point(0.5), in: graph, tolerance: 6)?.id == edge.id)119        #expect(g.edge(at: CGPoint(x: -5000, y: -5000), in: graph, tolerance: 6) == nil)120        let out = g.outputPoint(node: "a", port: "out", frame: g.frames["a"]!)121        #expect(g.outputPort(at: out, tolerance: 8)?.node == "a")122    }123124    @Test func arrowKeysFollowConnections() {125        let graph = WorkflowGraph(document: Self.document())126        let g = CanvasGeometry(graph: graph)127        #expect(CanvasNavigation.next(from: nil, direction: .right, graph: graph, geometry: g) == "trigger:0")128        #expect(CanvasNavigation.next(from: "trigger:0", direction: .right, graph: graph, geometry: g) == "a")129        #expect(CanvasNavigation.next(from: "a", direction: .right, graph: graph, geometry: g) == "b")130        #expect(CanvasNavigation.next(from: "b", direction: .down, graph: graph, geometry: g) == "c")131        #expect(CanvasNavigation.next(from: "c", direction: .up, graph: graph, geometry: g) == "b")132        #expect(CanvasNavigation.next(from: "b", direction: .left, graph: graph, geometry: g) == "a")133        #expect(CanvasNavigation.next(from: "each", direction: .right, graph: graph, geometry: g) == "inner")134        #expect(CanvasNavigation.next(from: "inner", direction: .left, graph: graph, geometry: g) == "each")135    }136137    @Test func viewportZoomKeepsTheAnchorAndFitShowsEverything() {138        var vp = CanvasViewport()139        vp.offset = CGSize(width: 30, height: -10)140        let anchor = CGPoint(x: 400, y: 300)141        let before = vp.toWorld(anchor)142        vp.zoom(by: 1.7, anchor: anchor)143        let after = vp.toWorld(anchor)144        #expect(abs(before.x - after.x) < 0.001 && abs(before.y - after.y) < 0.001)145        vp.zoom(by: 1000, anchor: anchor)146        #expect(vp.zoom == CanvasViewport.maxZoom)147148        let bounds = CGRect(x: -280, y: 0, width: 3000, height: 900)149        let size = CGSize(width: 1000, height: 600)150        vp.fit(bounds, in: size)151        #expect(CGRect(origin: .zero, size: size).contains(vp.toScreen(bounds).insetBy(dx: 1, dy: 1)))152        #expect(CanvasGeometry.snap(33) == 40 && CanvasGeometry.snap(29) == 20)153    }154155    @Test func stepKeysMapToStepIDsAndStatusesAggregate() {156        #expect(WorkflowStudioModel.stepID(fromKey: "each[2]/copy") == "copy")157        #expect(WorkflowStudioModel.stepID(fromKey: "par(left)/a") == "a")158        #expect(WorkflowStudioModel.stepID(fromKey: "poll#3/check") == "check")159        #expect(WorkflowStudioModel.stepID(fromKey: "write") == "write")160        let merged = WorkflowStudioModel.aggregate(["each[0]/copy": .succeeded, "each[1]/copy": .failed, "each[2]/copy": .running, "a": .simulated])161        #expect(merged["copy"]?.status == .running && merged["copy"]?.instances == 3)162        #expect(merged["a"]?.status == .simulated)163    }164}165166@Suite("Unit · triggers, parameters and palette") struct FormLogicTests {167    @Test func cronTriggerGivesTheNextThreeFireTimes() {168        var calendar = Calendar(identifier: .gregorian)169        calendar.timeZone = TimeZone(identifier: "America/Toronto")!170        let now = calendar.date(from: DateComponents(year: 2027, month: 3, day: 1, hour: 8))!171        let dates = TriggerPreview.nextFireDates(.schedule(cron: "0 12 * * *", timezone: "America/Toronto"), after: now)172        #expect(dates.count == 3)173        #expect(dates.map { calendar.component(.hour, from: $0) } == [12, 12, 12])174        #expect(dates.map { calendar.component(.day, from: $0) } == [1, 2, 3])175        #expect(TriggerPreview.nextFireDates(.schedule(cron: "not a cron", timezone: nil), after: now).isEmpty)176        #expect(TriggerPreview.nextFireDates(.schedule(cron: "0 12 * * *", timezone: "Mars/Olympus"), after: now).isEmpty)177        let every = TriggerPreview.nextFireDates(.interval(seconds: 600), after: now)178        #expect(every.map { $0.timeIntervalSince(now) } == [600, 1200, 1800])179        #expect(TriggerPreview.nextFireDates(.login, after: now).isEmpty)180    }181182    @Test func parameterFormIsTypedAndLeavesDefaultsToTheEngine() throws {183        let params = [WorkflowParameter(name: "folder", type: .path, defaultValue: "~/Out"), WorkflowParameter(name: "count", type: .integer, defaultValue: 3),184                      WorkflowParameter(name: "flag", type: .boolean), WorkflowParameter(name: "who", required: true)]185        #expect(try ParameterForm.values(params, texts: ["who": "me"]).get() == ["who": "me"])186        #expect(try ParameterForm.values(params, texts: ["who": "me", "count": "7", "flag": "true", "folder": "~/Else"]).get() == ["who": "me", "count": 7, "flag": true, "folder": "~/Else"])187        #expect(throws: FormError.self) { try ParameterForm.values(params, texts: ["who": "me", "count": "seven"]).get() }188        #expect(throws: FormError.self) { try ParameterForm.values(params, texts: [:]).get() }189    }190191    @Test func freshIDsAreValidAndUnique() {192        var doc = Palette.blankDocument(existingIDs: ["new-workflow"])193        #expect(doc.metadata.id == "new-workflow-2")194        #expect(WorkflowValidator.structuralErrors(doc).isEmpty)195        #expect(Palette.freshID("start", in: doc) == "start2")196        #expect(Palette.freshID("9 lives!", in: doc) == "step9lives")197        doc.spec.steps.append(WorkflowStep(id: "start2", kind: .fail(FailStep(message: "x"))))198        #expect(Palette.freshID("start", in: doc) == "start3")199        #expect(Palette.idBase(forTool: "documents.csvRead") == "csvRead")200        #expect(Palette.matches("file list", "filesystem.list Lists FILES") && !Palette.matches("zip", "filesystem.list"))201    }202}203
Files main
Menu

Theme