lawspec 0.25.0 → 0.26.0
This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
- package/CHANGELOG.md +43 -1
- package/README.md +5 -4
- package/api.mjs +0 -8
- package/bin/lawspec.mjs +14 -52
- package/build.json +77 -105
- package/core.wasm +2 -2
- package/core_jsffi.js +5 -0
- package/examples/native-payments/clojure/lawspec.json +1 -1
- package/examples/native-payments/csharp/lawspec.json +1 -1
- package/examples/native-payments/elixir/lawspec.json +1 -1
- package/examples/native-payments/erlang/lawspec.json +1 -1
- package/examples/native-payments/fsharp/lawspec.json +1 -1
- package/examples/native-payments/gleam/lawspec.json +1 -1
- package/examples/native-payments/go/lawspec.json +1 -1
- package/examples/native-payments/groovy/lawspec.json +1 -1
- package/examples/native-payments/haskell/lawspec.json +1 -1
- package/examples/native-payments/java/lawspec.json +1 -1
- package/examples/native-payments/javascript/lawspec.json +1 -1
- package/examples/native-payments/kotlin/lawspec.json +1 -1
- package/examples/native-payments/python/lawspec.json +1 -1
- package/examples/native-payments/rust/lawspec.json +1 -1
- package/examples/native-payments/scala/lawspec.json +1 -1
- package/examples/native-payments/swift/lawspec.json +1 -1
- package/examples/native-payments/typescript/lawspec.json +1 -1
- package/examples/packages/orders/lawspec.json +1 -1
- package/examples/packages/orders/orders.lawspec +27 -25
- package/examples/packages/shop-domain/src/domain.lawspec +15 -14
- package/examples/packages/shop-tax-1/src/api.lawspec +1 -0
- package/examples/packages/shop-tax-1/src/rates.lawspec +1 -0
- package/examples/packages/shop-tax-2/src/api.lawspec +1 -0
- package/examples/packages/shop-tax-2/src/rates.lawspec +1 -0
- package/examples/rc1/authorization-snapshots.lawspec +24 -23
- package/examples/rc1/banner-filenames.lawspec +7 -6
- package/examples/rc1/bit-codec.lawspec +12 -11
- package/examples/rc1/bounded-witness-search.lawspec +52 -45
- package/examples/rc1/conflicting-requirements.lawspec +8 -7
- package/examples/rc1/constructive-witnesses.lawspec +40 -33
- package/examples/rc1/documentary-review.lawspec +9 -8
- package/examples/rc1/empty-domains.lawspec +16 -15
- package/examples/rc1/finite-integer-domains.lawspec +24 -23
- package/examples/rc1/law-metadata.lawspec +6 -5
- package/examples/rc1/native-payments.lawspec +17 -16
- package/examples/rc1/nesting/rrr.lawspec +4 -3
- package/examples/rc1/nesting/rru.lawspec +7 -6
- package/examples/rc1/nesting/rur.lawspec +7 -6
- package/examples/rc1/nesting/ruu.lawspec +10 -9
- package/examples/rc1/nesting/urr.lawspec +7 -6
- package/examples/rc1/nesting/uru.lawspec +10 -9
- package/examples/rc1/nesting/uur.lawspec +10 -9
- package/examples/rc1/nesting/uuu.lawspec +13 -12
- package/examples/rc1/order-workflow.lawspec +18 -17
- package/examples/rc1/parcel-measurements.lawspec +14 -13
- package/examples/rc1/picture-records.lawspec +6 -5
- package/examples/rc1/picture-tuples.lawspec +6 -5
- package/examples/rc1/record-payloads.lawspec +12 -11
- package/examples/rc1/recursive-records.lawspec +11 -10
- package/examples/rc1/refund-conformance.lawspec +7 -6
- package/examples/rc1/refund-policy.lawspec +15 -14
- package/examples/rc1/requirement-composition.lawspec +26 -25
- package/examples/rc1/structural-records.lawspec +13 -12
- package/examples/rc1-authoring.lawspec +6 -5
- package/examples/specs/abilities.lawspec +67 -65
- package/examples/specs/ability_imports.lawspec +58 -57
- package/examples/specs/actors.lawspec +23 -22
- package/examples/specs/algebra.lawspec +142 -141
- package/examples/specs/approvals.lawspec +16 -15
- package/examples/specs/async_bindings.lawspec +10 -9
- package/examples/specs/async_fetch.lawspec +12 -11
- package/examples/specs/atoi_codec.lawspec +16 -15
- package/examples/specs/boolean_flags.lawspec +10 -9
- package/examples/specs/builtins.lawspec +73 -72
- package/examples/specs/canonical_url.lawspec +14 -13
- package/examples/specs/collections.lawspec +153 -154
- package/examples/specs/composition.lawspec +70 -66
- package/examples/specs/concurrent_collections.lawspec +8 -7
- package/examples/specs/consistency.lawspec +4 -3
- package/examples/specs/contracts.lawspec +80 -79
- package/examples/specs/crypto.lawspec +26 -25
- package/examples/specs/ctc.lawspec +148 -0
- package/examples/specs/currying.lawspec +32 -31
- package/examples/specs/data_types.lawspec +50 -49
- package/examples/specs/distribution.lawspec +57 -56
- package/examples/specs/domain_modeling.lawspec +48 -47
- package/examples/specs/durations.lawspec +39 -38
- package/examples/specs/equivalent.lawspec +25 -24
- package/examples/specs/failures.lawspec +64 -63
- package/examples/specs/finite_data.lawspec +32 -31
- package/examples/specs/flow_stack.lawspec +64 -63
- package/examples/specs/gadt_expressions.lawspec +50 -49
- package/examples/specs/generation.lawspec +115 -114
- package/examples/specs/handler_bindings.lawspec +42 -40
- package/examples/specs/handles.lawspec +2 -1
- package/examples/specs/harness.lawspec +45 -43
- package/examples/specs/harness_testing.lawspec +18 -13
- package/examples/specs/indexed_arithmetic.lawspec +401 -126
- package/examples/specs/indexed_families.lawspec +182 -66
- package/examples/specs/keywords.lawspec +22 -21
- package/examples/specs/limits.lawspec +6 -5
- package/examples/specs/list_contracts.lawspec +121 -120
- package/examples/specs/list_refinements.lawspec +43 -42
- package/examples/specs/lists.lawspec +45 -44
- package/examples/specs/matchers.lawspec +79 -78
- package/examples/specs/matching.lawspec +43 -42
- package/examples/specs/mixed_inputs.lawspec +25 -24
- package/examples/specs/models.lawspec +44 -43
- package/examples/specs/parse_port.lawspec +28 -27
- package/examples/specs/payments.lawspec +55 -54
- package/examples/specs/railway.lawspec +59 -58
- package/examples/specs/records.lawspec +149 -148
- package/examples/specs/records_inner.lawspec +5 -4
- package/examples/specs/recursive_refinements.lawspec +30 -29
- package/examples/specs/refined_definitions.lawspec +24 -23
- package/examples/specs/refinements.lawspec +58 -57
- package/examples/specs/resilience.lawspec +159 -158
- package/examples/specs/resources.lawspec +61 -60
- package/examples/specs/scalar_adapters.lawspec +60 -59
- package/examples/specs/scalar_catalog.lawspec +165 -164
- package/examples/specs/scalars.lawspec +78 -77
- package/examples/specs/scheduling_order.lawspec +8 -7
- package/examples/specs/scheduling_overlap.lawspec +5 -4
- package/examples/specs/sequences.lawspec +66 -65
- package/examples/specs/sessions.lawspec +13 -12
- package/examples/specs/slug.lawspec +16 -15
- package/examples/specs/sum_refinements.lawspec +42 -41
- package/examples/specs/tables.lawspec +29 -28
- package/examples/specs/total_functions.lawspec +71 -70
- package/examples/specs/workflows.lawspec +101 -100
- package/examples-command.mjs +4 -6
- package/explain.mjs +6 -4
- package/expression-presentation.mjs +8 -8
- package/files.mjs +1 -1
- package/index.d.ts +4 -527
- package/launcher.mjs +9 -2
- package/lsp.mjs +10 -6
- package/native-examples.mjs +2 -2
- package/package.json +1 -1
- package/starter-rc1.lawspec +6 -5
- package/starter.lawspec +16 -15
- package/templates.mjs +4 -2
- package/migrate.mjs +0 -135
- package/migration-bindings.mjs +0 -86
- package/migration-cases.mjs +0 -45
- package/migration-collections.mjs +0 -54
- package/migration-correspondence.mjs +0 -275
- package/migration-generation.mjs +0 -99
- package/migration-laws.mjs +0 -102
- package/migration-records.mjs +0 -166
- package/migration-source.mjs +0 -247
- package/migration-write.mjs +0 -156
|
@@ -44,42 +44,42 @@ end function
|
|
|
44
44
|
law sampleWeight is
|
|
45
45
|
description:
|
|
46
46
|
"A sample parcel weighs one gram."
|
|
47
|
-
end
|
|
47
|
+
end description
|
|
48
48
|
definition:
|
|
49
49
|
sampleParcel () must be Parcel record{details = record{
|
|
50
50
|
weight = Measurement record{reading = record{value = 1}}
|
|
51
51
|
}}
|
|
52
|
-
end
|
|
53
|
-
end
|
|
52
|
+
end definition
|
|
53
|
+
end law
|
|
54
54
|
|
|
55
55
|
law positiveWeights is
|
|
56
56
|
description:
|
|
57
57
|
"Every accepted parcel measurement has a positive weight."
|
|
58
|
-
end
|
|
58
|
+
end description
|
|
59
59
|
definition:
|
|
60
60
|
for all (parcel of type record{
|
|
61
61
|
weight of type (measurement of type Measurement Integer
|
|
62
62
|
where measurement.reading.value > 0)
|
|
63
63
|
}) =>
|
|
64
64
|
weightOf parcel > 0
|
|
65
|
-
end
|
|
66
|
-
end
|
|
65
|
+
end for all
|
|
66
|
+
end definition
|
|
67
67
|
expect weightOf parcel = expected
|
|
68
68
|
in table (parcel, expected):
|
|
69
69
|
row record{weight = Measurement record{reading = record{value = 1}}}, 1
|
|
70
70
|
row record{weight = Measurement record{reading = record{value = 3}}}, 3
|
|
71
|
-
end
|
|
72
|
-
end
|
|
71
|
+
end table
|
|
72
|
+
end law
|
|
73
73
|
|
|
74
74
|
law recipientLabels is
|
|
75
75
|
description:
|
|
76
76
|
"Deliveries preserve the recipient written on their label."
|
|
77
|
-
end
|
|
77
|
+
end description
|
|
78
78
|
definition:
|
|
79
79
|
for all (delivery of type Delivery DeliveryLabel) =>
|
|
80
80
|
recipient delivery = recipient delivery
|
|
81
|
-
end
|
|
82
|
-
end
|
|
81
|
+
end for all
|
|
82
|
+
end definition
|
|
83
83
|
expect recipient delivery = expected
|
|
84
84
|
in table (delivery, expected):
|
|
85
85
|
row Delivery record{contents = record{value = DeliveryLabel record{
|
|
@@ -88,5 +88,6 @@ law recipientLabels is
|
|
|
88
88
|
row Delivery record{contents = record{value = DeliveryLabel record{
|
|
89
89
|
code = 8, recipient = "Bo"
|
|
90
90
|
}}}, "Bo"
|
|
91
|
-
end
|
|
92
|
-
end
|
|
91
|
+
end table
|
|
92
|
+
end law
|
|
93
|
+
end unit
|
|
@@ -28,7 +28,7 @@ end function
|
|
|
28
28
|
law "|named dimensions determine orientation| is
|
|
29
29
|
description:
|
|
30
30
|
"Dimension labels preserve their meaning in either field order."
|
|
31
|
-
end
|
|
31
|
+
end description
|
|
32
32
|
definition:
|
|
33
33
|
for all (picture of type Picture) =>
|
|
34
34
|
orientation picture must be
|
|
@@ -37,8 +37,8 @@ law "|named dimensions determine orientation| is
|
|
|
37
37
|
else Square
|
|
38
38
|
end if
|
|
39
39
|
end if
|
|
40
|
-
end
|
|
41
|
-
end
|
|
40
|
+
end for all
|
|
41
|
+
end definition
|
|
42
42
|
expect orientation picture = expected
|
|
43
43
|
in table (picture, expected):
|
|
44
44
|
row Picture record{fileName = "wide.jpg", dimensions = record{width = 12,
|
|
@@ -47,5 +47,6 @@ law "|named dimensions determine orientation| is
|
|
|
47
47
|
width = 8}}, Portrait
|
|
48
48
|
row Picture record{fileName = "square.jpg", dimensions = record{width = 10,
|
|
49
49
|
height = 10}}, Square
|
|
50
|
-
end
|
|
51
|
-
end
|
|
50
|
+
end table
|
|
51
|
+
end law
|
|
52
|
+
end unit
|
|
@@ -24,7 +24,7 @@ end function
|
|
|
24
24
|
law "|tuple dimensions determine orientation| is
|
|
25
25
|
description:
|
|
26
26
|
"Width comes first and height second in a picture's dimensions."
|
|
27
|
-
end
|
|
27
|
+
end description
|
|
28
28
|
definition:
|
|
29
29
|
for all (picture of type Picture) =>
|
|
30
30
|
orientation picture must be
|
|
@@ -36,12 +36,13 @@ law "|tuple dimensions determine orientation| is
|
|
|
36
36
|
end if
|
|
37
37
|
end if
|
|
38
38
|
end case
|
|
39
|
-
end
|
|
40
|
-
end
|
|
39
|
+
end for all
|
|
40
|
+
end definition
|
|
41
41
|
expect orientation picture = expected
|
|
42
42
|
in table (picture, expected):
|
|
43
43
|
row Picture record{fileName = "wide.jpg", dimensions = (12, 8)}, Landscape
|
|
44
44
|
row Picture record{fileName = "tall.jpg", dimensions = (8, 12)}, Portrait
|
|
45
45
|
row Picture record{fileName = "square.jpg", dimensions = (10, 10)}, Square
|
|
46
|
-
end
|
|
47
|
-
end
|
|
46
|
+
end table
|
|
47
|
+
end law
|
|
48
|
+
end unit
|
|
@@ -28,29 +28,30 @@ function boxedPayload (box of type Box a) -> record{value of type a} is
|
|
|
28
28
|
law pictureWidth is definition:
|
|
29
29
|
width (Picture record{fileName = "photo", dimensions = record{height = 3,
|
|
30
30
|
width = 2}}) must be 2
|
|
31
|
-
end end
|
|
31
|
+
end definition end law
|
|
32
32
|
law downloadLabel is definition: label (Download record{document = "paper"})
|
|
33
|
-
must be "paper" end end
|
|
33
|
+
must be "paper" end definition end law
|
|
34
34
|
law wrappedText is definition: extract (Envelope record{payload = record{value =
|
|
35
|
-
"note", copy = "other"}}) must be "note" end end
|
|
35
|
+
"note", copy = "other"}}) must be "note" end definition end law
|
|
36
36
|
law wrappedBoolean is definition: extract (Envelope record{payload =
|
|
37
|
-
record{value = true, copy = false}}) must be true end end
|
|
37
|
+
record{value = true, copy = false}}) must be true end definition end law
|
|
38
38
|
law wholeRecord is definition: unpack (Envelope record{payload = record{value =
|
|
39
|
-
true, copy = false}}) = record{copy = false, value = true} end end
|
|
39
|
+
true, copy = false}}) = record{copy = false, value = true} end definition end law
|
|
40
40
|
law boxedResult is definition: boxedPayload (Box record{value = true}) =
|
|
41
|
-
record{value = true} end end
|
|
41
|
+
record{value = true} end definition end law
|
|
42
42
|
law boxedRows is definition: for all (box of type Box Text) => boxedPayload box
|
|
43
|
-
= boxedPayload box end end
|
|
43
|
+
= boxedPayload box end for all end definition
|
|
44
44
|
expect (boxedPayload box).value = expected in table (box, expected):
|
|
45
45
|
row Box record{value = "note"}, "note"
|
|
46
46
|
row Box record{value = "paper"}, "paper"
|
|
47
|
-
end end
|
|
47
|
+
end table end law
|
|
48
48
|
law labels is
|
|
49
49
|
definition: for all (delivery of type Delivery) => label delivery = label
|
|
50
|
-
delivery end end
|
|
50
|
+
delivery end for all end definition
|
|
51
51
|
expect label delivery = expected
|
|
52
52
|
in table (delivery, expected):
|
|
53
53
|
row Download record{document = "paper"}, "paper"
|
|
54
54
|
row Unavailable, "unavailable"
|
|
55
|
-
end
|
|
56
|
-
end
|
|
55
|
+
end table
|
|
56
|
+
end law
|
|
57
|
+
end unit
|
|
@@ -35,23 +35,23 @@ law "|an unissued approval has no finite construction| is
|
|
|
35
35
|
definition:
|
|
36
36
|
for all (approval of type UnissuedApproval) =>
|
|
37
37
|
false
|
|
38
|
-
end
|
|
39
|
-
end
|
|
40
|
-
end
|
|
38
|
+
end for all
|
|
39
|
+
end definition
|
|
40
|
+
end law
|
|
41
41
|
|
|
42
42
|
law "|mutually dependent snapshots have no first value| is
|
|
43
43
|
definition:
|
|
44
44
|
for all (snapshot of type FirstSnapshot) =>
|
|
45
45
|
false
|
|
46
|
-
end
|
|
47
|
-
end
|
|
48
|
-
end
|
|
46
|
+
end for all
|
|
47
|
+
end definition
|
|
48
|
+
end law
|
|
49
49
|
|
|
50
50
|
law "|a completed chain has no remaining approval| is
|
|
51
51
|
definition:
|
|
52
52
|
chainLength (ApprovalChain record{next = Nothing}) must be 0
|
|
53
|
-
end
|
|
54
|
-
end
|
|
53
|
+
end definition
|
|
54
|
+
end law
|
|
55
55
|
|
|
56
56
|
law "|a pending chain counts each remaining approval| is
|
|
57
57
|
definition:
|
|
@@ -60,5 +60,6 @@ law "|a pending chain counts each remaining approval| is
|
|
|
60
60
|
next = Just (ApprovalChain record{next = Nothing})
|
|
61
61
|
})
|
|
62
62
|
}) must be 2
|
|
63
|
-
end
|
|
64
|
-
end
|
|
63
|
+
end definition
|
|
64
|
+
end law
|
|
65
|
+
end unit
|
|
@@ -7,16 +7,16 @@ nativeRefund of type policy.RefundRequest -> policy.RefundDecision
|
|
|
7
7
|
law "|native refunds conform to the policy| is
|
|
8
8
|
description:
|
|
9
9
|
"The application's refund decision agrees with the checked policy."
|
|
10
|
-
end
|
|
10
|
+
end description
|
|
11
11
|
definition:
|
|
12
12
|
for all (request of type policy.RefundRequest) =>
|
|
13
13
|
nativeRefund request must be policy.refund request
|
|
14
|
-
end
|
|
15
|
-
end
|
|
14
|
+
end for all
|
|
15
|
+
end definition
|
|
16
16
|
|
|
17
17
|
references:
|
|
18
18
|
ref function policy.refund
|
|
19
|
-
end
|
|
19
|
+
end references
|
|
20
20
|
|
|
21
21
|
expect nativeRefund request = expected
|
|
22
22
|
in table (request, expected):
|
|
@@ -40,5 +40,6 @@ law "|native refunds conform to the policy| is
|
|
|
40
40
|
flagged = false}, policy.Approved
|
|
41
41
|
row policy.RefundRequest record{capturedAmount = 9007199254740992,
|
|
42
42
|
requestedAmount = 9007199254740993, flagged = false}, policy.Rejected
|
|
43
|
-
end
|
|
44
|
-
end
|
|
43
|
+
end table
|
|
44
|
+
end law
|
|
45
|
+
end unit
|
|
@@ -25,24 +25,24 @@ end function
|
|
|
25
25
|
law "|a zero refund is approved| is
|
|
26
26
|
description:
|
|
27
27
|
"A zero request transfers nothing and needs no review."
|
|
28
|
-
end
|
|
28
|
+
end description
|
|
29
29
|
definition:
|
|
30
30
|
for all (capturedAmount of type Whole) (flagged of type Bool) =>
|
|
31
31
|
refund (RefundRequest record{
|
|
32
32
|
capturedAmount = capturedAmount, requestedAmount = 0, flagged = flagged
|
|
33
33
|
}) must be Approved
|
|
34
|
-
end
|
|
35
|
-
end
|
|
36
|
-
end
|
|
34
|
+
end for all
|
|
35
|
+
end definition
|
|
36
|
+
end law
|
|
37
37
|
|
|
38
38
|
law "|a refund cannot exceed the captured amount| is
|
|
39
39
|
definition:
|
|
40
40
|
for all (request of type RefundRequest) =>
|
|
41
41
|
request.requestedAmount > request.capturedAmount implies
|
|
42
42
|
refund request must be Rejected
|
|
43
|
-
end
|
|
44
|
-
end
|
|
45
|
-
end
|
|
43
|
+
end for all
|
|
44
|
+
end definition
|
|
45
|
+
end law
|
|
46
46
|
|
|
47
47
|
law "|an eligible flagged refund requires review| is
|
|
48
48
|
definition:
|
|
@@ -50,17 +50,17 @@ law "|an eligible flagged refund requires review| is
|
|
|
50
50
|
request.requestedAmount > 0 and
|
|
51
51
|
request.requestedAmount <= request.capturedAmount and request.flagged
|
|
52
52
|
implies refund request must be ReviewRequired
|
|
53
|
-
end
|
|
54
|
-
end
|
|
55
|
-
end
|
|
53
|
+
end for all
|
|
54
|
+
end definition
|
|
55
|
+
end law
|
|
56
56
|
|
|
57
57
|
law "|an eligible unflagged refund is approved| is
|
|
58
58
|
definition:
|
|
59
59
|
for all (request of type RefundRequest) =>
|
|
60
60
|
request.requestedAmount <= request.capturedAmount and not request.flagged
|
|
61
61
|
implies refund request must be Approved
|
|
62
|
-
end
|
|
63
|
-
end
|
|
62
|
+
end for all
|
|
63
|
+
end definition
|
|
64
64
|
|
|
65
65
|
expect refund request = expected
|
|
66
66
|
in table (request, expected):
|
|
@@ -84,5 +84,6 @@ law "|an eligible unflagged refund is approved| is
|
|
|
84
84
|
= false}, Approved
|
|
85
85
|
row RefundRequest record{capturedAmount = 9007199254740992, requestedAmount
|
|
86
86
|
= 9007199254740993, flagged = false}, Rejected
|
|
87
|
-
end
|
|
88
|
-
end
|
|
87
|
+
end table
|
|
88
|
+
end law
|
|
89
|
+
end unit
|
|
@@ -8,10 +8,10 @@ law "|each item has a match| (relation of type a -> b -> Bool) is
|
|
|
8
8
|
for all (item of type b) =>
|
|
9
9
|
there exists (witness of type a) such that
|
|
10
10
|
relation witness item
|
|
11
|
-
end
|
|
12
|
-
end
|
|
13
|
-
end
|
|
14
|
-
end
|
|
11
|
+
end exists
|
|
12
|
+
end for all
|
|
13
|
+
end definition
|
|
14
|
+
end law
|
|
15
15
|
|
|
16
16
|
function revokedMatch (authorization of type Authorization)
|
|
17
17
|
(payment of type Payment) -> Bool is
|
|
@@ -26,25 +26,25 @@ law "|matching and readiness agree| is
|
|
|
26
26
|
there exists (authorization of type Authorization
|
|
27
27
|
where active Ready authorization) such that
|
|
28
28
|
authorizes authorization payment
|
|
29
|
-
end
|
|
30
|
-
end)
|
|
31
|
-
end
|
|
29
|
+
end exists
|
|
30
|
+
end for all)
|
|
31
|
+
end definition
|
|
32
32
|
|
|
33
33
|
description:
|
|
34
34
|
"Every payment has a matching identity and an active approval when ready."
|
|
35
|
-
end
|
|
36
|
-
end
|
|
35
|
+
end description
|
|
36
|
+
end law
|
|
37
37
|
|
|
38
38
|
law "|revocation or matching has a complete explanation| is
|
|
39
39
|
definition:
|
|
40
40
|
(must not apply law "|each item has a match| revokedMatch)
|
|
41
41
|
or apply law "|each item has a match| authorizes
|
|
42
|
-
end
|
|
42
|
+
end definition
|
|
43
43
|
|
|
44
44
|
description:
|
|
45
45
|
"Either revoked approvals cannot cover every payment, or matching succeeds."
|
|
46
|
-
end
|
|
47
|
-
end
|
|
46
|
+
end description
|
|
47
|
+
end law
|
|
48
48
|
|
|
49
49
|
law "|matching implies ready approval coverage| is
|
|
50
50
|
definition:
|
|
@@ -54,36 +54,37 @@ law "|matching implies ready approval coverage| is
|
|
|
54
54
|
there exists (authorization of type Authorization
|
|
55
55
|
where active Ready authorization) such that
|
|
56
56
|
authorizes authorization payment
|
|
57
|
-
end
|
|
58
|
-
end)
|
|
59
|
-
end
|
|
60
|
-
end
|
|
57
|
+
end exists
|
|
58
|
+
end for all)
|
|
59
|
+
end definition
|
|
60
|
+
end law
|
|
61
61
|
|
|
62
62
|
law "|payment and approval identities have separate scopes| is
|
|
63
63
|
definition:
|
|
64
64
|
(for all (value of type Payment) =>
|
|
65
65
|
value = FirstPayment or value = SecondPayment
|
|
66
|
-
end)
|
|
66
|
+
end for all)
|
|
67
67
|
and
|
|
68
68
|
(for all (value of type Authorization) =>
|
|
69
69
|
value = FirstApproval or value = SecondApproval
|
|
70
|
-
end)
|
|
71
|
-
end
|
|
72
|
-
end
|
|
70
|
+
end for all)
|
|
71
|
+
end definition
|
|
72
|
+
end law
|
|
73
73
|
|
|
74
74
|
law "|an empty condition does not hide required coverage| is
|
|
75
75
|
definition:
|
|
76
76
|
(for all (authorization of type Authorization where false) =>
|
|
77
77
|
false
|
|
78
|
-
end)
|
|
78
|
+
end for all)
|
|
79
79
|
and
|
|
80
80
|
(there exists (authorization of type Authorization
|
|
81
81
|
where active Ready authorization) such that
|
|
82
82
|
authorizes authorization FirstPayment
|
|
83
|
-
end)
|
|
84
|
-
end
|
|
83
|
+
end exists)
|
|
84
|
+
end definition
|
|
85
85
|
|
|
86
86
|
rationale:
|
|
87
87
|
"A vacuous first clause leaves the approval requirement in force."
|
|
88
|
-
end
|
|
89
|
-
end
|
|
88
|
+
end rationale
|
|
89
|
+
end law
|
|
90
|
+
end unit
|
|
@@ -17,37 +17,38 @@ law doubles is
|
|
|
17
17
|
definition:
|
|
18
18
|
for all (value of type record{count of type Integer}) =>
|
|
19
19
|
(double value).count must be value.count + value.count
|
|
20
|
-
end
|
|
21
|
-
end
|
|
20
|
+
end for all
|
|
21
|
+
end definition
|
|
22
22
|
|
|
23
23
|
expect double value = expected
|
|
24
24
|
in table (value, expected):
|
|
25
25
|
row record{count = -1}, record{count = -2}
|
|
26
26
|
row record{count = 0}, record{count = 0}
|
|
27
27
|
row record{count = 1}, record{count = 2}
|
|
28
|
-
end
|
|
29
|
-
end
|
|
28
|
+
end table
|
|
29
|
+
end law
|
|
30
30
|
|
|
31
31
|
law wraps is
|
|
32
32
|
definition:
|
|
33
33
|
(wrap true).wrapped must be true
|
|
34
|
-
end
|
|
35
|
-
end
|
|
34
|
+
end definition
|
|
35
|
+
end law
|
|
36
36
|
|
|
37
37
|
law ordered is
|
|
38
38
|
definition:
|
|
39
39
|
record{a = 1, b = true} must be record{b = true, a = 1}
|
|
40
|
-
end
|
|
41
|
-
end
|
|
40
|
+
end definition
|
|
41
|
+
end law
|
|
42
42
|
|
|
43
43
|
law nested is
|
|
44
44
|
definition:
|
|
45
45
|
record{inner = record{count = 4}}.inner.count must be 4
|
|
46
|
-
end
|
|
47
|
-
end
|
|
46
|
+
end definition
|
|
47
|
+
end law
|
|
48
48
|
|
|
49
49
|
law empty is
|
|
50
50
|
definition:
|
|
51
51
|
record{} must be record{}
|
|
52
|
-
end
|
|
53
|
-
end
|
|
52
|
+
end definition
|
|
53
|
+
end law
|
|
54
|
+
end unit
|
|
@@ -7,21 +7,21 @@ end function
|
|
|
7
7
|
law "|addition preserves the inputs| is
|
|
8
8
|
description:
|
|
9
9
|
"Adding two amounts gives their mathematical sum."
|
|
10
|
-
end
|
|
10
|
+
end description
|
|
11
11
|
|
|
12
12
|
definition:
|
|
13
13
|
for all (a of type Integer) (b of type Integer) =>
|
|
14
14
|
a `|adds the values| b must be a + b
|
|
15
|
-
end
|
|
16
|
-
end
|
|
15
|
+
end for all
|
|
16
|
+
end definition
|
|
17
17
|
|
|
18
18
|
expect "|adds the values| a b = expected
|
|
19
19
|
in table (a, b, expected):
|
|
20
20
|
row -1, 1, 0
|
|
21
21
|
row 0, 0, 0
|
|
22
22
|
row 1, 2, 3
|
|
23
|
-
end
|
|
24
|
-
end
|
|
23
|
+
end table
|
|
24
|
+
end law
|
|
25
25
|
|
|
26
26
|
type Picture is a record{
|
|
27
27
|
fileName of type Text
|
|
@@ -54,3 +54,4 @@ function "|picture category| (width of type Nat) -> Text is
|
|
|
54
54
|
otherwise "large"
|
|
55
55
|
end case
|
|
56
56
|
end function
|
|
57
|
+
end unit
|
|
@@ -5,9 +5,9 @@ unit example.abilities
|
|
|
5
5
|
-- Gateway says so, and every law about it holds for every lawful handler:
|
|
6
6
|
-- the native one written by hand, and each spec handler below.
|
|
7
7
|
|
|
8
|
-
type Payment is | Approved
|
|
9
|
-
type Receipt is
|
|
10
|
-
type PaymentError is | Refused | TooLarge end
|
|
8
|
+
type Payment is one of | Approved of type Int32 | Declined end type
|
|
9
|
+
type Receipt is a record{ cents :: Int32} end type
|
|
10
|
+
type PaymentError is one of | Refused | TooLarge end type
|
|
11
11
|
|
|
12
12
|
-- A payment gateway. Its laws are obligations on every handler.
|
|
13
13
|
ability Gateway is
|
|
@@ -15,89 +15,91 @@ ability Gateway is
|
|
|
15
15
|
capture :: Int32 -> Receipt
|
|
16
16
|
fee :: Int32
|
|
17
17
|
laws
|
|
18
|
-
law
|
|
19
|
-
definition
|
|
20
|
-
end
|
|
21
|
-
law
|
|
22
|
-
definition
|
|
23
|
-
|
|
24
|
-
(
|
|
25
|
-
|
|
26
|
-
|
|
27
|
-
end) = true
|
|
28
|
-
end
|
|
29
|
-
end
|
|
30
|
-
law
|
|
31
|
-
definition
|
|
32
|
-
end
|
|
33
|
-
end
|
|
18
|
+
law "|a receipt is for the amount captured| is
|
|
19
|
+
definition : for all (cents :: Int32) => capture cents = Receipt record{ cents = cents} end for all end definition
|
|
20
|
+
end law
|
|
21
|
+
law "|an approval is for the amount asked| is
|
|
22
|
+
definition :
|
|
23
|
+
for all (cents :: Int32) =>
|
|
24
|
+
(first matching case of authorize cents :
|
|
25
|
+
when Approved approved then approved = cents
|
|
26
|
+
when Declined then true
|
|
27
|
+
end case) = true end for all
|
|
28
|
+
end definition
|
|
29
|
+
end law
|
|
30
|
+
law "|the fee is never negative| is
|
|
31
|
+
definition : fee >= 0 end definition
|
|
32
|
+
end law
|
|
33
|
+
end laws
|
|
34
|
+
end ability
|
|
34
35
|
|
|
35
36
|
-- A fake for tests: it approves small amounts.
|
|
36
37
|
handler fakeGateway for Gateway is
|
|
37
|
-
authorize cents is if cents <= 10000 then Approved cents else Declined end
|
|
38
|
-
capture cents is Receipt cents end
|
|
39
|
-
fee is 30 end
|
|
40
|
-
end
|
|
38
|
+
operation authorize cents is if cents <= 10000 then Approved cents else Declined end if end operation
|
|
39
|
+
operation capture cents is Receipt record{ cents = cents} end operation
|
|
40
|
+
operation fee is 30 end operation
|
|
41
|
+
end handler
|
|
41
42
|
|
|
42
43
|
-- A handler with state: it keeps every amount it captured.
|
|
43
44
|
handler keepingGateway for Gateway with state captured :: List Int32 start [] is
|
|
44
|
-
authorize cents is Approved cents end
|
|
45
|
-
capture cents is ~captured := Cons cents captured; Receipt cents end
|
|
46
|
-
fee is 0 end
|
|
47
|
-
end
|
|
45
|
+
operation authorize cents is Approved cents end operation
|
|
46
|
+
operation capture cents is ~captured := Cons cents captured; Receipt record{ cents = cents} end operation
|
|
47
|
+
operation fee is 0 end operation
|
|
48
|
+
end handler
|
|
48
49
|
|
|
49
50
|
-- A checked definition that uses Gateway. Its row, {Gateway}, is inferred.
|
|
50
|
-
|
|
51
|
-
|
|
52
|
-
|
|
53
|
-
|
|
54
|
-
end
|
|
55
|
-
end
|
|
51
|
+
procedure checkout (cents :: Int32) -> Bool is
|
|
52
|
+
first matching case of authorize cents :
|
|
53
|
+
when Approved amount then (first matching case of capture amount : when Receipt record{ cents = paid} then paid = cents end case)
|
|
54
|
+
when Declined then false
|
|
55
|
+
end case
|
|
56
|
+
end procedure
|
|
56
57
|
|
|
57
58
|
-- A native adapter that uses Gateway: it gets a handler as its first
|
|
58
59
|
-- argument.
|
|
59
60
|
charge :: Int32 -> Bool uses Gateway
|
|
60
61
|
|
|
61
62
|
-- A definition that can fail says what it fails with.
|
|
62
|
-
|
|
63
|
+
procedure pay (cents :: Int32) -> Receipt uses Gateway fails with PaymentError is
|
|
63
64
|
if cents > 100000 then raise TooLarge else
|
|
64
|
-
|
|
65
|
-
|
|
66
|
-
|
|
67
|
-
end
|
|
68
|
-
end
|
|
65
|
+
first matching case of authorize cents :
|
|
66
|
+
when Approved amount then capture amount
|
|
67
|
+
when Declined then raise Refused
|
|
68
|
+
end case end if
|
|
69
|
+
end procedure
|
|
69
70
|
|
|
70
71
|
-- Counting calls is part of the claim, so the law names a recording
|
|
71
72
|
-- handler. Which gateway it records is left to the harness: each lawful one.
|
|
72
|
-
law
|
|
73
|
-
definition
|
|
74
|
-
|
|
75
|
-
(if checkout cents then calls of capture with (cents)
|
|
76
|
-
end
|
|
77
|
-
end
|
|
73
|
+
law "|checkout captures once, and only when it succeeds| using recording Gateway is
|
|
74
|
+
definition :
|
|
75
|
+
for all (cents :: Int32) =>
|
|
76
|
+
(if checkout cents then calls of capture with (cents) = 1 else calls of capture = 0 end if) = true end for all
|
|
77
|
+
end definition
|
|
78
|
+
end law
|
|
78
79
|
|
|
79
|
-
law
|
|
80
|
-
definition
|
|
81
|
-
|
|
82
|
-
(if charge cents then calls of capture with (cents)
|
|
83
|
-
end
|
|
84
|
-
end
|
|
80
|
+
law "|charge captures once, and only when it succeeds| using recording Gateway is
|
|
81
|
+
definition :
|
|
82
|
+
for all (cents :: Int32) =>
|
|
83
|
+
(if charge cents then calls of capture with (cents) = 1 else calls of capture = 0 end if) = true end for all
|
|
84
|
+
end definition
|
|
85
|
+
end law
|
|
85
86
|
|
|
86
87
|
-- This law needs the fake's limit, so the fake is part of the claim.
|
|
87
|
-
law
|
|
88
|
-
definition
|
|
89
|
-
|
|
90
|
-
end
|
|
91
|
-
end
|
|
88
|
+
law "|large payments fail| using fakeGateway is
|
|
89
|
+
definition :
|
|
90
|
+
for all (cents :: Int32 where cents > 100000) => prelude.attempt (pay cents) = Left TooLarge end for all
|
|
91
|
+
end definition
|
|
92
|
+
end law
|
|
92
93
|
|
|
93
|
-
law
|
|
94
|
-
definition
|
|
95
|
-
|
|
96
|
-
prelude.attempt (pay cents) = Left Refused
|
|
97
|
-
end
|
|
98
|
-
end
|
|
94
|
+
law "|a declined payment is refused| using fakeGateway is
|
|
95
|
+
definition :
|
|
96
|
+
for all (cents :: Int32 where cents > 10000 && cents <= 100000) =>
|
|
97
|
+
prelude.attempt (pay cents) = Left Refused end for all
|
|
98
|
+
end definition
|
|
99
|
+
end law
|
|
99
100
|
|
|
100
101
|
-- Without `using`, a law runs under each lawful handler in turn.
|
|
101
|
-
law
|
|
102
|
-
definition
|
|
103
|
-
end
|
|
102
|
+
law "|the fee is small| is
|
|
103
|
+
definition : fee <= 100 end definition
|
|
104
|
+
end law
|
|
105
|
+
end unit
|