magic.lambda.slots
11.0.1
See the version list below for details.
dotnet add package magic.lambda.slots --version 11.0.1
NuGet\Install-Package magic.lambda.slots -Version 11.0.1
<PackageReference Include="magic.lambda.slots" Version="11.0.1" />
paket add magic.lambda.slots --version 11.0.1
#r "nuget: magic.lambda.slots, 11.0.1"
// Install magic.lambda.slots as a Cake Addin #addin nuget:?package=magic.lambda.slots&version=11.0.1 // Install magic.lambda.slots as a Cake Tool #tool nuget:?package=magic.lambda.slots&version=11.0.1
Creating dynamic slots from Hyperlambda
This project provides the ability to create, invoke (signal), modify, inspect, and delete dynamic slots for Magic. More specifically, this project provides the following slots.
- [signal] - Invokes a dynamically create slot that has been created with the [slots.create] slot
- [slots.create] - Creates a dynamic slot, that can be invoked with the [signal] slot
- [slots.get] - Returns the entire lambda object for a slot that has been previously created with the [slots.create] slot
- [slots.delete] - Deletes a slot that has been previously created with the [slots.create] slot
- [slots.exists] - Returns true of the given slot exists
- [return-nodes] - Returns a bunch of nodes to caller from inside of your slot
- [return-value] - Returns a single value to caller from inside of your slot
- [return] - Returns either a list of nodes, or a single value, or both, depending upon the results of its expression, or whether or not it has a static value, or a list of nodes
- [slots.vocabulary] - Returns the names of all dynamically created slots
/*
* First we create a dynamic slot.
*/
slots.create:foo
return-value:int:57
/*
* Then we invoke it.
*/
signal:foo
After evaluation of the above Hyperlambda, the value of the [signal] node will be 57. Notice, if you invoke [slots.create] for a slot that has already been created, the old slot will be overwritten with the new lambda object you pass into it. Also notice that if you try to invoke a slot that doesn't exist, or you try to get its content, an exception will be thrown.
Also realize that when you create a slot, it is not persisted in any ways - Implying if the web server process is restarted, your slot will disappear. To avoid this, put the creation of your slot inside a file in a folder called "magic.startup" in your module's folder, e.g. "/files/modules/foo-module/magic.startup/create-slot.hl". All files inside of modules that exists within a "magic.startup" folder will be executed every time your web server restarts for some reasons.
[slots.create]
Creates a dynamic slot that can be invoked using [signal]. Below is an example.
slots.create:foo
return-value:int:57
Notice, the above slot aren't persisted in any ways, implying if your web server restarts its process, your slot is removed. If you want to make sure your slots becomes a permanent part of your application, you need to make sure you are somehow creating it during server startup, which can normally be done on a per module basis, by putting a Hyperlambda file into your module's "magic.startup" folder, which makes sure the code is executed during startup of your web app.
[signal]
Invokes a previously created dynamic slot. Assuming you have executed the above code snippet, you can invoke the slot using the following Hyperlambda.
signal:foo
After evaluating the above Hyperlambda, the [signal] node will end up having a value of "57".
Notice - This slot obeys by the rules of [whitelist] invocations from magic.lambda, allowing you to declare a list of dynamic slots, which are exclusively allowed to be invoked temporarily inside of an invocation to whitelist, allowing you to restrict some piece of potentially unsafe code to only signal a pre-defined list of dynamically created slots. Below is an example.
slots.create:foo1
return-value:Safe
slots.create:foo2
return-value:Unsafe
whitelist
vocabulary
signal
signal:foo1
.lambda
// Assuming you have a [foo1] slot created, this will work
signal:foo1
// This will throw, since [foo2] is not whitelisted
signal:foo2
Basically, only the slots declared in the above [vocabulary] will be allowed to be invoked inside of the above [.lambda] object. You must have your dynamic slots declared as signal:slot-name, such as the above illustrates. And in order to signal dynamic slots at all, you'll need to (obviously) whitelist [signal] itself, as illustrated in the above code. Read more about [whitelist] in the magic.lambda project. Inside your slots though any [whitelist] invocations will simply be ignored, allowing you to whitelist a single dynamic slot, for then to ignore what the slot itself is doing internally. This might create security issues for you if you have dynamically created slots that for some reasons execute lambda object supplied to them. Hence as a general rule of thumb, you should avoid whitelisting slots that executes lambda objects supplied to them.
[slots.get]
Returns the entire lambda code for a previously created dynamic slot. Example can be found below.
slots.create:foo
return-value:int:57
slots.get:foo
[slots.delete]
Deletes a previously created dynamic slot. The following example will throw an exception.
slots.create:foo
return-value:int:57
slots.delete:foo
// Throws exception, since [foo] no longer exists.
slots.get:foo
[return-nodes]
Returns a bunch of nodes (lambda) from your slot. Can only be invoked from the inside of a dynamically created slot, and other slots explicitly creating a return context. An example can be found below.
slots.create:foo
return-nodes
integer-value:int:57
string-value:Foo bar
signal:foo
[return-value]
Returns a single value from your slot. Can only be invoked from the inside of a dynamically created slot, and other slots explicitly creating a return context. An example can be found below.
slots.create:foo
return-value:This becomes the returned value from your slot
signal:foo
[slots.exists]
Returns true if the specified slot exists. Example can be found below.
slots.create:foo
return-value:Blah, blah, blah ...
slots.exists:foo
slots.exists:DOES-NOT-EXISTS
[slots.vocabulary]
Returns the names of all dynamically created slots to caller. Example can be found below.
slots.vocabulary
Project website
The source code for this repository can be found at github.com/polterguy/magic.lambda.slots, and you can provide feedback, provide bug reports, etc at the same place.
Quality gates
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.lambda.caching (>= 11.0.0)
- magic.node.extensions (>= 11.0.0)
- magic.signals.contracts (>= 11.0.0)
NuGet packages (1)
Showing the top 1 NuGet packages that depend on magic.lambda.slots:
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.1 | 421 | 1/22/2024 |
17.2.0 | 130 | 1/22/2024 |
17.1.7 | 193 | 1/12/2024 |
17.1.6 | 154 | 1/11/2024 |
17.1.5 | 173 | 1/5/2024 |
17.0.1 | 221 | 1/1/2024 |
17.0.0 | 363 | 12/14/2023 |
16.11.5 | 373 | 11/12/2023 |
16.9.0 | 371 | 10/9/2023 |
16.7.0 | 606 | 7/11/2023 |
16.4.1 | 412 | 7/2/2023 |
16.4.0 | 400 | 6/22/2023 |
16.3.1 | 369 | 6/7/2023 |
16.3.0 | 351 | 5/28/2023 |
16.1.9 | 681 | 4/30/2023 |
15.10.11 | 505 | 4/13/2023 |
15.9.1 | 616 | 3/27/2023 |
15.9.0 | 497 | 3/24/2023 |
15.8.2 | 568 | 3/20/2023 |
15.7.0 | 429 | 3/6/2023 |
15.5.0 | 1,659 | 1/28/2023 |
15.2.0 | 743 | 1/18/2023 |
15.1.0 | 1,189 | 12/28/2022 |
14.5.7 | 754 | 12/13/2022 |
14.5.5 | 837 | 12/6/2022 |
14.5.1 | 697 | 11/23/2022 |
14.5.0 | 638 | 11/18/2022 |
14.4.5 | 737 | 10/22/2022 |
14.4.1 | 762 | 10/22/2022 |
14.4.0 | 674 | 10/17/2022 |
14.3.1 | 1,280 | 9/12/2022 |
14.3.0 | 668 | 9/10/2022 |
14.1.3 | 951 | 8/7/2022 |
14.1.2 | 673 | 8/7/2022 |
14.1.1 | 703 | 8/7/2022 |
14.0.14 | 727 | 7/26/2022 |
14.0.12 | 704 | 7/24/2022 |
14.0.11 | 646 | 7/23/2022 |
14.0.10 | 662 | 7/23/2022 |
14.0.9 | 701 | 7/23/2022 |
14.0.8 | 750 | 7/17/2022 |
14.0.5 | 809 | 7/11/2022 |
14.0.4 | 814 | 7/6/2022 |
14.0.3 | 746 | 7/2/2022 |
14.0.2 | 672 | 7/2/2022 |
14.0.1 | 712 | 7/2/2022 |
14.0.0 | 690 | 6/25/2022 |
13.4.0 | 2,071 | 5/31/2022 |
13.3.4 | 1,455 | 5/9/2022 |
13.3.0 | 946 | 5/1/2022 |
13.2.0 | 1,169 | 4/21/2022 |
13.1.0 | 1,047 | 4/7/2022 |
13.0.0 | 743 | 4/5/2022 |
11.0.7 | 1,151 | 3/10/2022 |
11.0.5 | 838 | 3/2/2022 |
11.0.4 | 769 | 2/22/2022 |
11.0.3 | 815 | 2/9/2022 |
11.0.2 | 790 | 2/6/2022 |
11.0.1 | 805 | 2/5/2022 |
10.0.21 | 781 | 1/28/2022 |
10.0.20 | 757 | 1/27/2022 |
10.0.19 | 776 | 1/23/2022 |
10.0.18 | 742 | 1/17/2022 |
10.0.15 | 1,004 | 12/31/2021 |
10.0.14 | 616 | 12/28/2021 |
10.0.8 | 1,259 | 12/22/2021 |
10.0.7 | 617 | 12/22/2021 |
10.0.5 | 763 | 12/18/2021 |
9.9.9 | 1,678 | 11/29/2021 |
9.9.3 | 949 | 11/9/2021 |
9.9.2 | 644 | 11/4/2021 |
9.9.0 | 822 | 10/30/2021 |
9.8.9 | 719 | 10/29/2021 |
9.8.7 | 667 | 10/27/2021 |
9.8.6 | 665 | 10/27/2021 |
9.8.5 | 685 | 10/26/2021 |
9.8.0 | 1,385 | 10/20/2021 |
9.7.9 | 621 | 10/19/2021 |
9.7.5 | 1,515 | 10/14/2021 |
9.7.0 | 858 | 10/9/2021 |
9.6.6 | 1,261 | 8/14/2021 |
9.2.0 | 6,317 | 5/26/2021 |
9.1.4 | 1,320 | 4/21/2021 |
9.1.0 | 1,045 | 4/14/2021 |
9.0.0 | 928 | 4/5/2021 |
8.9.9 | 1,048 | 3/30/2021 |
8.9.3 | 1,582 | 3/19/2021 |
8.9.2 | 1,080 | 1/29/2021 |
8.9.1 | 1,028 | 1/24/2021 |
8.9.0 | 1,134 | 1/22/2021 |
8.6.9 | 3,110 | 11/8/2020 |
8.6.6 | 2,005 | 11/2/2020 |
8.6.0 | 4,053 | 10/28/2020 |
8.5.0 | 1,926 | 10/23/2020 |
8.4.2 | 3,523 | 10/16/2020 |
8.4.1 | 1,238 | 10/16/2020 |
8.4.0 | 2,034 | 10/13/2020 |
8.3.1 | 2,695 | 10/5/2020 |
8.3.0 | 1,284 | 10/3/2020 |
8.2.2 | 2,054 | 9/26/2020 |
8.2.1 | 1,351 | 9/25/2020 |
8.2.0 | 1,410 | 9/25/2020 |
8.1.17 | 6,844 | 9/13/2020 |
8.1.16 | 571 | 9/13/2020 |
8.1.15 | 1,262 | 9/12/2020 |
8.1.11 | 3,212 | 9/11/2020 |
8.1.10 | 699 | 9/6/2020 |
8.1.9 | 2,019 | 9/3/2020 |
8.1.8 | 1,326 | 9/2/2020 |
8.1.7 | 1,237 | 8/28/2020 |
8.1.4 | 1,228 | 8/25/2020 |
8.1.3 | 1,321 | 8/18/2020 |
8.1.2 | 1,227 | 8/16/2020 |
8.1.1 | 1,276 | 8/15/2020 |
8.1.0 | 596 | 8/15/2020 |
8.0.1 | 2,759 | 8/7/2020 |
8.0.0 | 1,258 | 8/7/2020 |
7.0.1 | 1,327 | 6/28/2020 |
7.0.0 | 1,353 | 6/28/2020 |
5.0.1 | 2,131 | 5/30/2020 |
5.0.0 | 6,123 | 2/25/2020 |
4.0.4 | 7,998 | 1/27/2020 |
4.0.3 | 1,238 | 1/27/2020 |
4.0.2 | 1,374 | 1/16/2020 |
4.0.1 | 1,411 | 1/11/2020 |
4.0.0 | 1,386 | 1/5/2020 |
3.1.1 | 4,246 | 12/4/2019 |
3.1.0 | 2,822 | 11/10/2019 |
3.0.0 | 3,918 | 10/23/2019 |
2.0.3 | 4,448 | 10/18/2019 |
2.0.2 | 1,850 | 10/18/2019 |
2.0.1 | 3,438 | 10/15/2019 |
2.0.0 | 1,664 | 10/13/2019 |
1.1.9 | 1,401 | 10/11/2019 |
1.1.8 | 1,333 | 10/10/2019 |
1.1.7 | 629 | 10/9/2019 |
1.1.6 | 620 | 10/7/2019 |
1.1.5 | 627 | 10/6/2019 |
1.1.4 | 582 | 10/6/2019 |
1.1.2 | 617 | 10/5/2019 |