import { matches } from "https://deno.land/x/embassyd_sdk@v0.3.3.0.5/dependencies.ts";
const { matches } = matches;
A Parser is usually a function that takes a value and returns a Parsed value. For this class we have that as our main reason but we want to be able to have other methods including testing and showing text representations.
The main function unsafeCast which will take in a value A (usually unknown) and will always return a B. If it cannot it will throw an error.
The parse function is the lower level function that will take in a value and a dictionary of what to do with success and failure.
Constructors
Properties
Use this as a guard clause, useful for escaping during the error cases. https://www.typescriptlang.org/docs/handbook/advanced-types.html#type-guards-and-differentiating-types
Methods
This is the like the unsafe parser, it assumes the happy path and will throw and return a failed promise during failure.
Use this when you want to combine two parsers into one. This will make sure that both parsers will run against the same value.
There are times that we would like to bring in a value that we know as null or undefined and want it to go to a default value
This is another type of parsing that will return a value that is a discriminated union of the success and failure cases. https://www.typescriptlang.org/docs/handbook/typescript-in-5-minutes-func.html#discriminated-unions
When we want to get the error message from the input, to know what is wrong
Use this that we want to do transformations after the value is valid and parsed. A use case would be parsing a string, making sure it can be parsed to a number, and then convert to a number
Use this when we want to give the parser a name, and we want to be able to use the name in the error messages.
When we want to make sure that we handle the null later on in a monoid fashion, and this ensures we deal with the value https://www.typescriptlang.org/docs/handbook/release-notes/typescript-3-7.html#optional-chaining
Use this to combine parsers into one. This will make sure that one or the other parsers will run against the value.
We want to refine to a new type given an original type, like isEven, or casting to a more specific type
This is the most useful parser, it assumes the happy path and will throw an error if it fails.
Static Methods
This is a constructor helper that can use a predicate tester in the form of a guard function, and will return a parser that will only parse if the predicate returns true. https://www.typescriptlang.org/docs/handbook/advanced-types.html#type-guards-and-differentiating-types
Trying to convert the parser into a string representation
Properties
Use this as a guard clause, useful for escaping during the error cases. https://www.typescriptlang.org/docs/handbook/advanced-types.html#type-guards-and-differentiating-types
Methods
This is the like the unsafe parser, it assumes the happy path and will throw and return a failed promise during failure.
Use this when you want to combine two parsers into one. This will make sure that both parsers will run against the same value.
There are times that we would like to bring in a value that we know as null or undefined and want it to go to a default value
This is another type of parsing that will return a value that is a discriminated union of the success and failure cases. https://www.typescriptlang.org/docs/handbook/typescript-in-5-minutes-func.html#discriminated-unions
When we want to get the error message from the input, to know what is wrong
Use this that we want to do transformations after the value is valid and parsed. A use case would be parsing a string, making sure it can be parsed to a number, and then convert to a number
Use this when we want to give the parser a name, and we want to be able to use the name in the error messages.
When we want to make sure that we handle the null later on in a monoid fashion, and this ensures we deal with the value https://www.typescriptlang.org/docs/handbook/release-notes/typescript-3-7.html#optional-chaining
Use this to combine parsers into one. This will make sure that one or the other parsers will run against the value.
We want to refine to a new type given an original type, like isEven, or casting to a more specific type
This is the most useful parser, it assumes the happy path and will throw an error if it fails.
Static Methods
This is a constructor helper that can use a predicate tester in the form of a guard function, and will return a parser that will only parse if the predicate returns true. https://www.typescriptlang.org/docs/handbook/advanced-types.html#type-guards-and-differentiating-types
Trying to convert the parser into a string representation
import { type matches } from "https://deno.land/x/embassyd_sdk@v0.3.3.0.5/dependencies.ts";
const { matches } = matches;
Methods
import { type matches } from "https://deno.land/x/embassyd_sdk@v0.3.3.0.5/dependencies.ts";
const { matches } = matches;
import { matches } from "https://deno.land/x/embassyd_sdk@v0.3.3.0.5/dependencies.ts";
const { matches } = matches;
Want to be able to bring in the declarative nature that a functional programming language feature of the pattern matching and the switch statement. With the destructors the only thing left was to find the correct structure then move move forward. Using a structure in chainable fashion allows for a syntax that works with typescript while looking similar to matches statements in other languages
Use: matches('a value').when(matches.isNumber, (aNumber) => aNumber + 4).defaultTo('fallback value')
import { matches } from "https://deno.land/x/embassyd_sdk@v0.3.3.0.5/dependencies.ts";
const { matches } = matches;
We would like to validate that all of the array is of the same type