magic.lambda.validators
16.3.1
See the version list below for details.
dotnet add package magic.lambda.validators --version 16.3.1
NuGet\Install-Package magic.lambda.validators -Version 16.3.1
<PackageReference Include="magic.lambda.validators" Version="16.3.1" />
paket add magic.lambda.validators --version 16.3.1
#r "nuget: magic.lambda.validators, 16.3.1"
// Install magic.lambda.validators as a Cake Addin #addin nuget:?package=magic.lambda.validators&version=16.3.1 // Install magic.lambda.validators as a Cake Tool #tool nuget:?package=magic.lambda.validators&version=16.3.1
magic.lambda.validators - Hyperlambda validators
This project contains argument validators for Hyperlambda. More specifically it contains the following slots.
- [validators.date] - Verifies that some date input is a date, and optionally between [min] and [max] value
- [validators.email] - Verifies that some input is a legal email address
- [validators.enum] - Verifies that some input is one of a set of predefined legal values, found as values of children
- [validators.integer] - Verifies that some integer input (long, int, etc) is between some specified [min] and [max] range
- [validators.mandatory] - Verifies that some input valus is given (at all)
- [validators.regex] - Verifies that some input is matching some given [regex] pattern
- [validators.string] - Verifies that some string input is between [min] and [max] in length
- [validators.url] - Verifies that some string input is a legal URL, either HTTP or HTTPS type of scheme
- [validators.recaptcha] - reCAPTCHA validator, to avoid bots from invoking your APIs
- [validators.default] - Default validator, adding default argument if not specified
All of the above slots takes an expression, or values, as its main input, and will throw exceptions if their input expression's value(s), or its value, does not follow the rules specified by the validator. Some of the above slots takes additional arguments. This makes them perfect fits for "intercepting" the input specified to an HTTP REST endpoint, to verify the input data conforms to some sort of predefined validation scheme.
Commonalities between validators
.foo
email:foo@bar.com
validators.email:x:@.foo/*/email
Most Hyperlambda validators requires some sort of argument(s) - However, some of these validators does not require arguments, such as the email validator, that simply verifies the input is a valid email address. To use the [validators.regex] validator, you should probably learn regular expression. However, this is beyond the scope of this article.
Notice - No attempt to invoke the type validator logic will be done unless the value is a non null value. If you want to enforce such logic, you'll have to combine the specific type validators with the [validators.mandatory] validator, that enforces that a value must be specified and not have a null value.
How to use [validators.date]
This slot works similarly to the [validator.integer] validator, except instead of providing a min/max integer value, you're expected to provide a min/max date value. Below is an example of how you could use it.
validators.date:x:@.arguments/*/date
min:date:"2005-01-21T23:59:47"
max:date:"2023-01-21T23:59:47"
How to use [validators.email]
This slot takes no arguments besides an expression, and will throw an exception unless the value of the node the expression is leading to is a valid email address. Below is example usage.
.arg:foo@bar.com
validators.email:x:@.arg
How to use [validators.enum]
This validator will throw an exception unless the specified string argument is one of the legal values. Usage could be as follows.
validators.enum:x:@.arguments/*/enum_value
.:val1
.:val2
If the above [enum_value] is not either val1
or val2
the validator will throw an exception.
How to use [validators.integer]
This value takes a [min] and [max] value, both of which are optional, and declares the minimum, and/or maximum value of the integer input. Usage could be as follows.
validators.integer:x:@.arguments/*/some-integer-argument
min:50
max:100
If the specified integer value is not within the range of the min and max value, an exception will be thrown.
How to use [validators.mandatory]
This slot simply throws an exception if the specified argument is not supplied. Below is example usage.
validators.mandatory:x:@.arguments/*/mandatory_arg
How to use [validators.regex]
This validator requires a [regex] argument, that is a regular expression that must match the argument specified. Usage can be found below.
.arguments
foo:howdy world
validators.regex:x:@.arguments/*/foo
regex:howdy
If you remove the "howdy" parts of your above argument, an exception will be thrown.
How to use [validators.string]
This works the same way as the [validators.integer] validator, except instead of being a min/max value the min/max arguments declares the minimum and maximum length of the string, allowing you to restrict string length of arguments to a min/max value for your Hyperlambda. Below is example usage that will throw an exception unless the argument is between 5 and 15 characters in length.
validators.string:x:@.some-arg
min:5
max:15
How to use [validators.url]
This is similar to the [validators.email] slot, except it requires the argument to be a valid URL instead of a valid email. Below is example usage.
validators.url:x:@.some-url
How to use [validators.recaptcha]
This is probably the most complex validator, and required 3 arguments.
- [site-key] - Site key as provided to you by Google's reCAPTCHA admin panel
- [secret] - Secret as provided to you by Google's reCAPTCHA admin panel
- [min] - Minimum value, a decimal value between 0 and 1. A good value here is typically 0.3
To use this validator you will need a Google reCAPTCHA account, version 3, at which point you can use it as follows.
validators.recaptcha:x:@.arguments/*/recaptcha_value
site-key:xyz
secret:qwerty
min:decimal:0.3
How to use [validators.default]
This validator takes one or more arguments with any name and any value, and if this node does not exist as a child of the node collection specified as its expression value, it appends the node to it. If the node exists but has a null value, it sets its value to the value of the argument.
.arguments
validators.default:x:@.arguments
foo1:bar1
Validator internals
You can use one invocation to any of the validators to validate multiple nodes, such as the following illustrates.
.arguments
.
no:5
.
no:10
.
// Throws if you remove the "."
.no:11
validators.integer:x:@.arguments/*/*/no
min:5
max:10
First the above expression will be evaluated, then every resulting value will be validated, and if any of them are not validated according to the validator's arguments - Which for the above example is number between 5 and 10 - The validater will throw an exception, providing the invalid value, and the name of the last iterator (effectively being the argument name) to the caller. This allows you to use one single validator to validate multiple arguments, such as the above illustrates. This might be useful if you for instance have an endpoint accepting multiple address fields, and zip code is a mandatory argument, and it needs to be an integer with a [max] and [min] value.
Project website for magic.lambda.validators
The source code for this repository can be found at github.com/polterguy/magic.lambda.validators, and you can provide feedback, provide bug reports, etc at the same place.
Copyright and maintenance
The projects is copyright of Aista, Ltd 2021 - 2023, and professionally maintained by AINIRO your friendly ChatGPT website chatbot vendor.
Product | Versions Compatible and additional computed target framework versions. |
---|---|
.NET | net5.0 was computed. net5.0-windows was computed. net6.0 was computed. net6.0-android was computed. net6.0-ios was computed. net6.0-maccatalyst was computed. net6.0-macos was computed. net6.0-tvos was computed. net6.0-windows was computed. net7.0 was computed. net7.0-android was computed. net7.0-ios was computed. net7.0-maccatalyst was computed. net7.0-macos was computed. net7.0-tvos was computed. net7.0-windows was computed. net8.0 was computed. net8.0-android was computed. net8.0-browser was computed. net8.0-ios was computed. net8.0-maccatalyst was computed. net8.0-macos was computed. net8.0-tvos was computed. net8.0-windows was computed. |
.NET Core | netcoreapp2.0 was computed. netcoreapp2.1 was computed. netcoreapp2.2 was computed. netcoreapp3.0 was computed. netcoreapp3.1 was computed. |
.NET Standard | netstandard2.0 is compatible. netstandard2.1 was computed. |
.NET Framework | net461 was computed. net462 was computed. net463 was computed. net47 was computed. net471 was computed. net472 was computed. net48 was computed. net481 was computed. |
MonoAndroid | monoandroid was computed. |
MonoMac | monomac was computed. |
MonoTouch | monotouch was computed. |
Tizen | tizen40 was computed. tizen60 was computed. |
Xamarin.iOS | xamarinios was computed. |
Xamarin.Mac | xamarinmac was computed. |
Xamarin.TVOS | xamarintvos was computed. |
Xamarin.WatchOS | xamarinwatchos was computed. |
-
.NETStandard 2.0
- magic.node.extensions (>= 16.3.1)
- magic.signals.contracts (>= 16.3.1)
- Newtonsoft.Json (>= 13.0.1)
NuGet packages (1)
Showing the top 1 NuGet packages that depend on magic.lambda.validators:
Package | Downloads |
---|---|
magic.library
Helper project for Magic to wire up everything easily by simply adding one package, and invoking two simple methods. When using Magic, this is (probably) the only package you should actually add, since this package pulls in everything else you'll need automatically, and wires up everything sanely by default. To use package go to https://polterguy.github.io |
GitHub repositories
This package is not used by any popular GitHub repositories.
Version | Downloads | Last updated |
---|---|---|
17.2.0 | 444 | 1/22/2024 |
17.1.7 | 191 | 1/12/2024 |
17.1.6 | 172 | 1/11/2024 |
17.1.5 | 187 | 1/5/2024 |
17.0.1 | 237 | 1/1/2024 |
17.0.0 | 382 | 12/14/2023 |
16.11.5 | 348 | 11/12/2023 |
16.9.0 | 334 | 10/9/2023 |
16.7.0 | 577 | 7/11/2023 |
16.4.1 | 418 | 7/2/2023 |
16.4.0 | 417 | 6/22/2023 |
16.3.1 | 346 | 6/7/2023 |
16.3.0 | 362 | 5/28/2023 |
16.1.9 | 640 | 4/30/2023 |
15.10.11 | 510 | 4/13/2023 |
15.9.1 | 650 | 3/27/2023 |
15.9.0 | 518 | 3/24/2023 |
15.8.2 | 547 | 3/20/2023 |
15.7.0 | 422 | 3/6/2023 |
15.5.0 | 1,600 | 1/28/2023 |
15.2.0 | 701 | 1/18/2023 |
15.1.0 | 1,162 | 12/28/2022 |
14.5.7 | 738 | 12/13/2022 |
14.5.5 | 801 | 12/6/2022 |
14.5.1 | 677 | 11/23/2022 |
14.5.0 | 611 | 11/18/2022 |
14.4.5 | 724 | 10/22/2022 |
14.4.1 | 795 | 10/22/2022 |
14.4.0 | 683 | 10/17/2022 |
14.3.1 | 1,279 | 9/12/2022 |
14.3.0 | 638 | 9/10/2022 |
14.1.3 | 937 | 8/7/2022 |
14.1.2 | 662 | 8/7/2022 |
14.1.1 | 678 | 8/7/2022 |
14.0.14 | 707 | 7/26/2022 |
14.0.12 | 684 | 7/24/2022 |
14.0.11 | 647 | 7/23/2022 |
14.0.10 | 679 | 7/23/2022 |
14.0.9 | 668 | 7/23/2022 |
14.0.8 | 761 | 7/17/2022 |
14.0.5 | 798 | 7/11/2022 |
14.0.4 | 781 | 7/6/2022 |
14.0.3 | 740 | 7/2/2022 |
14.0.2 | 692 | 7/2/2022 |
14.0.0 | 858 | 6/25/2022 |
13.4.0 | 2,076 | 5/31/2022 |
13.3.4 | 1,461 | 5/9/2022 |
13.3.0 | 966 | 5/1/2022 |
13.2.0 | 1,171 | 4/21/2022 |
13.1.1 | 750 | 4/20/2022 |
13.1.0 | 825 | 4/7/2022 |
13.0.0 | 761 | 4/5/2022 |
11.0.5 | 1,431 | 3/2/2022 |
11.0.4 | 791 | 2/22/2022 |
11.0.3 | 763 | 2/9/2022 |
11.0.2 | 841 | 2/6/2022 |
11.0.1 | 789 | 2/5/2022 |
10.0.21 | 767 | 1/28/2022 |
10.0.20 | 785 | 1/27/2022 |
10.0.19 | 772 | 1/23/2022 |
10.0.18 | 745 | 1/17/2022 |
10.0.15 | 944 | 12/31/2021 |
10.0.14 | 585 | 12/28/2021 |
10.0.7 | 1,471 | 12/22/2021 |
10.0.5 | 766 | 12/18/2021 |
9.9.9 | 1,686 | 11/29/2021 |
9.9.3 | 946 | 11/9/2021 |
9.9.2 | 670 | 11/4/2021 |
9.9.0 | 762 | 10/30/2021 |
9.8.9 | 703 | 10/29/2021 |
9.8.7 | 660 | 10/27/2021 |
9.8.6 | 656 | 10/27/2021 |
9.8.5 | 722 | 10/26/2021 |
9.8.0 | 1,379 | 10/20/2021 |
9.7.9 | 648 | 10/19/2021 |
9.7.5 | 1,486 | 10/14/2021 |
9.7.0 | 860 | 10/9/2021 |
9.6.6 | 1,230 | 8/14/2021 |
9.2.0 | 393 | 5/26/2021 |
9.1.7 | 6,932 | 5/3/2021 |
9.1.4 | 681 | 4/21/2021 |
9.1.0 | 1,061 | 4/14/2021 |
9.0.0 | 917 | 4/5/2021 |
8.9.9 | 1,016 | 3/30/2021 |
8.9.3 | 1,569 | 3/19/2021 |
8.9.2 | 1,025 | 1/29/2021 |
8.9.1 | 1,025 | 1/24/2021 |
8.9.0 | 1,087 | 1/22/2021 |
8.6.9 | 2,993 | 11/8/2020 |
8.6.6 | 1,968 | 11/2/2020 |
8.6.0 | 4,046 | 10/28/2020 |
8.5.0 | 1,918 | 10/23/2020 |
8.4.1 | 4,869 | 10/15/2020 |
8.4.0 | 1,324 | 10/13/2020 |
8.3.1 | 2,675 | 10/5/2020 |
8.3.0 | 1,263 | 10/3/2020 |
8.2.2 | 2,037 | 9/26/2020 |
8.2.1 | 1,343 | 9/25/2020 |
8.2.0 | 1,397 | 9/25/2020 |
8.1.17 | 6,783 | 9/13/2020 |
8.1.16 | 641 | 9/13/2020 |
8.1.15 | 1,932 | 9/12/2020 |
8.1.11 | 2,525 | 9/11/2020 |
8.1.10 | 1,311 | 9/6/2020 |
8.1.9 | 1,341 | 9/3/2020 |
8.1.8 | 1,306 | 9/2/2020 |
8.1.7 | 1,214 | 8/28/2020 |
8.1.4 | 1,235 | 8/25/2020 |
8.1.3 | 1,262 | 8/18/2020 |
8.1.2 | 1,232 | 8/16/2020 |
8.1.1 | 1,277 | 8/15/2020 |
8.1.0 | 588 | 8/15/2020 |
8.0.1 | 2,685 | 8/7/2020 |
8.0.0 | 1,237 | 8/7/2020 |
7.0.1 | 1,384 | 6/28/2020 |
7.0.0 | 1,378 | 6/28/2020 |
5.0.0 | 7,496 | 2/25/2020 |
4.0.4 | 7,997 | 1/27/2020 |
4.0.3 | 1,250 | 1/27/2020 |
4.0.2 | 1,423 | 1/16/2020 |
4.0.1 | 1,416 | 1/11/2020 |
4.0.0 | 1,349 | 1/5/2020 |
3.1.1 | 4,221 | 12/4/2019 |
3.1.0 | 2,780 | 11/10/2019 |
3.0.0 | 3,927 | 10/23/2019 |
2.0.0 | 6,643 | 10/18/2019 |