aboutsummaryrefslogtreecommitdiff
path: root/src/__OLD_parcom/assert.cr
diff options
context:
space:
mode:
authorMatthew Hall <hallmatthew314@gmail.com>2023-03-16 20:36:03 +1300
committerMatthew Hall <hallmatthew314@gmail.com>2023-03-16 20:36:03 +1300
commitb274828831fec26cd8b3089ffef14cb96ce2de2f (patch)
treeff5927b85a59b4d85c9e4aa269a475a7a37a54a0 /src/__OLD_parcom/assert.cr
parent77c370d27be174e0b036b33d1469e84e67a7153a (diff)
Second rewrite attempt, this one should work, monkaS
Diffstat (limited to 'src/__OLD_parcom/assert.cr')
-rw-r--r--src/__OLD_parcom/assert.cr45
1 files changed, 45 insertions, 0 deletions
diff --git a/src/__OLD_parcom/assert.cr b/src/__OLD_parcom/assert.cr
new file mode 100644
index 0000000..5a3e621
--- /dev/null
+++ b/src/__OLD_parcom/assert.cr
@@ -0,0 +1,45 @@
+require "./parser.cr"
+
+module Parcom
+ # `Assert` is a `Parser` that runs another `Parser` and then
+ # performs a test on its result. The parser will then either fail if
+ # the result does not pass the test, or forward it on if it does.
+ #
+ # Example:
+ # ```
+ # letter = Assert.new(AnyToken(Char).new) { |x| x.letter? }
+ # non_letter = Assert.new(AnyToken(Char).new) { |x| !x.letter? }
+ # input = Tokens.from_string("hi")
+ # letter.parse(input) # this succeeds
+ # non_letter.parse(input) # this fails
+ # ```
+ #
+ # `Assert` instance can also be created by calling
+ # `Parser#assert` on any parser:
+ # ```
+ # # This parser is identical to the above example.
+ # letter = AnyToken.new(Char).assert { |x| x.letter? }
+ # ```
+ class Assert(T, V) < Parser(T, V)
+ # Accepts the parser to run and a `Bool`-retuning block
+ # containing the test to perform on the other parser's result.
+ def initialize(@p : Parser(T, V), &block : V -> Bool)
+ @f = block
+ end
+
+ # Runs the parser it was initialized with, and returns that parser's
+ # result if it passes the provided test. Raises `ParserFail` otherwise.
+ def parse(tokens : Tokens(T)) : Result(T, V)
+ result = @p.parse(tokens)
+ rescue ex : ParserFail
+ raise ParserFail.new("Assert (pre-assertion): #{ex.message}")
+ else
+ unless @f.call(result.value)
+ raise ParserFail.new("Assert: predicate failed for <#{result.value}>")
+ end
+
+ return result
+ end
+ end
+end
+