magic.library
17.3.9
dotnet add package magic.library --version 17.3.9
NuGet\Install-Package magic.library -Version 17.3.9
<PackageReference Include="magic.library" Version="17.3.9" />
paket add magic.library --version 17.3.9
#r "nuget: magic.library, 17.3.9"
// Install magic.library as a Cake Addin #addin nuget:?package=magic.library&version=17.3.9 // Install magic.library as a Cake Tool #tool nuget:?package=magic.library&version=17.3.9
magic.library - Tying Magic together
This project helps you to wire up everything related to Magic. Normally you'd use it simply like the following from your startup class in your .Net 8 Web API project.
using Microsoft.AspNetCore.Builder;
using Microsoft.Extensions.Configuration;
using Microsoft.Extensions.DependencyInjection;
using magic.library;
namespace magic.backend
{
public class Startup
{
public Startup(IConfiguration configuration)
{
Configuration = configuration;
}
IConfiguration Configuration { get; }
public void ConfigureServices(IServiceCollection services)
{
// Initializing Magic.
services.AddMagic(Configuration);
}
public void Configure(IApplicationBuilder app)
{
// Initializing Magic.
app.UseMagic(Configuration);
}
}
}
However, you can also take more control over how things are actually wired up, by instead of using the
"do all methods" called AddMagic
and UseMagic
, invoke some of the specialized initialization methods,
you can find below.
IServiceCollection.AddMagicCaching
IServiceCollection.AddMagicHttp
IServiceCollection.AddMagicLogging
IServiceCollection.AddMagicSignals
IServiceCollection.AddMagicExceptions
IServiceCollection.AddMagicEndpoints
IServiceCollection.AddMagicAuthorization
IServiceCollection.AddMagicFileServices
IServiceCollection.AddMagicFileServices
IServiceCollection.AddMagicConfiguration
IServiceCollection.AddMagicScheduler
IServiceCollection.AddMagicMail
IServiceCollection.AddMagicLambda
IServiceCollection.AddMagicSockets
The above methods is basically what the AddMagic
method actually does, and they're extension methods of
IServiceCollection
, that can be found in the magic.library
namespace. Similar alternatives to UseMagic
can
be found below.
IApplicationBuilder.UseMagicExceptions
IApplicationBuilder.UseMagicStartupFiles
IApplicationBuilder.UseMagicScheduler
IApplicationBuilder.UseMagicCors
If you use these methods instead of the "do all methods", your motivation would probably
be to replace one of these methods with your own implementation, to exchange the default wiring, by (for instance)
using a "virtual database based file system" by creating your own service implementation of for instance IFileService
from "magic.lambda.io", or use a different logging provider than the default, etc. If you wish
to do this, you'd probably benefit from looking at what the default implementation of your method does, to understand the
requirements from your method. Doing this is very powerful, and allows you to change the way the system behaves by default -
But is also definitely considered an "advanced exercise".
Exceptions handlers
Magic allows you to provide a custom exceptions handler on a per folder level. This overrides the default exception logic with a custom exception handler expected to be named "exceptions.hl" and found within the folder hierarchy where an HTTP invocation is resolved. For instance, if you wish to create your own exception handler for a specific module called "foo", you can create an exception handler file called "/files/modules/foo/exceptions.hl", and expect this file to be invoked every time an unhandled exception occurs, anywhere inside of your "foo" folder. This allows you to transform an unhandled exception, such as for instance localising it or customising it in any ways. Your custom exception handler will be invoked with the following arguments.
- [message] - The exception error message
- [path] - The URL that triggered the exception
- [field] - If the exception that was thrown declared a field, this argument will contain the name of the field
- [status] - If the exception that was thrown declared a status code, this argument will contain the status code
- [public] - If the exception that was thrown wants to propagate to the client this will be true
You can return a "transformed" exception from your exception handler, returning the following arguments, that will end up becoming the response object returned to the client.
- [message] - Message to return as JSON to client
- [field] - Field to return as JSON to client
- [status] - Status code to decorate your HTTP response with
The default exception handler can be found in "/files/exceptions.hl", which will be invoked if no custom exception handler is declared further down in your folder hierarchy.
Magic's GitHub project page
Magic is 100% Open Source and you can find the primary project GitHub page here.
Project website for magic.lambda.library
The source code for this repository can be found at github.com/polterguy/magic.library, and you can provide feedback, provide bug reports, etc at the same place.
Copyright and maintenance
The projects is copyright Thomas Hansen 2023 - 2024, and professionally maintained by AINIRO.IO.
Product | Versions Compatible and additional computed target framework versions. |
---|---|
.NET | net8.0 is compatible. 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. |
-
net8.0
- magic.endpoint (>= 17.2.0)
- magic.endpoint.services (>= 17.3.5)
- magic.lambda (>= 17.2.0)
- magic.lambda.auth (>= 17.2.0)
- magic.lambda.caching (>= 17.2.0)
- magic.lambda.config (>= 17.2.0)
- magic.lambda.crypto (>= 17.2.0)
- magic.lambda.csv (>= 17.2.0)
- magic.lambda.dates (>= 17.2.0)
- magic.lambda.guid (>= 17.2.0)
- magic.lambda.html (>= 17.3.9)
- magic.lambda.http (>= 17.2.0)
- magic.lambda.hyperlambda (>= 17.2.0)
- magic.lambda.image (>= 17.2.0)
- magic.lambda.io (>= 17.2.0)
- magic.lambda.json (>= 17.2.0)
- magic.lambda.logging (>= 17.2.0)
- magic.lambda.mail (>= 17.2.0)
- magic.lambda.math (>= 17.2.0)
- magic.lambda.mime (>= 17.2.0)
- magic.lambda.mssql (>= 17.2.0)
- magic.lambda.mysql (>= 17.2.0)
- magic.lambda.odbc (>= 17.2.0)
- magic.lambda.openai (>= 17.2.0)
- magic.lambda.pdf (>= 17.2.0)
- magic.lambda.pgsql (>= 17.2.0)
- magic.lambda.scheduler (>= 17.2.0)
- magic.lambda.slots (>= 17.2.1)
- magic.lambda.sockets (>= 17.2.0)
- magic.lambda.sqlite (>= 17.2.0)
- magic.lambda.strings (>= 17.3.3)
- magic.lambda.threading (>= 17.2.0)
- magic.lambda.validators (>= 17.2.0)
- magic.lambda.xml (>= 17.2.0)
- magic.signals (>= 17.2.0)
- Microsoft.AspNetCore.Diagnostics (>= 2.2.0)
- Microsoft.AspNetCore.Mvc.NewtonsoftJson (>= 8.0.0)
- Microsoft.Extensions.Http (>= 8.0.0)
NuGet packages
This package is not used by any NuGet packages.
GitHub repositories
This package is not used by any popular GitHub repositories.
Version | Downloads | Last updated |
---|---|---|
17.3.9 | 197 | 2/17/2024 |
17.3.7 | 139 | 2/12/2024 |
17.3.6 | 93 | 2/12/2024 |
17.3.5 | 90 | 2/10/2024 |
17.3.4 | 99 | 2/9/2024 |
17.3.3 | 94 | 2/8/2024 |
17.3.2 | 103 | 2/2/2024 |
17.3.1 | 104 | 1/30/2024 |
17.2.2 | 87 | 1/30/2024 |
17.2.1 | 117 | 1/22/2024 |
17.2.0 | 90 | 1/22/2024 |
17.1.7 | 160 | 1/12/2024 |
17.1.6 | 122 | 1/11/2024 |
17.1.5 | 146 | 1/5/2024 |
17.0.1 | 188 | 1/1/2024 |
17.0.0 | 321 | 12/14/2023 |
16.11.6 | 215 | 11/14/2023 |
16.11.5 | 164 | 11/12/2023 |
16.9.0 | 282 | 10/9/2023 |
16.8.5 | 163 | 9/30/2023 |
16.8.4 | 157 | 9/25/2023 |
16.8.0 | 128 | 9/24/2023 |
16.7.51 | 120 | 9/24/2023 |
16.7.50 | 126 | 9/23/2023 |
16.7.1 | 179 | 9/4/2023 |
16.7.0 | 292 | 7/11/2023 |
16.6.13 | 189 | 7/6/2023 |
16.6.12 | 179 | 7/5/2023 |
16.6.11 | 165 | 7/5/2023 |
16.6.5 | 204 | 7/3/2023 |
16.4.4 | 202 | 7/2/2023 |
16.4.3 | 220 | 6/27/2023 |
16.4.2 | 203 | 6/25/2023 |
16.4.1 | 204 | 6/25/2023 |
16.4.0 | 192 | 6/22/2023 |
16.3.2 | 284 | 6/7/2023 |
16.3.0 | 291 | 5/28/2023 |
16.2.0 | 371 | 5/13/2023 |
16.1.10 | 358 | 5/1/2023 |
16.1.9 | 277 | 4/30/2023 |
16.1.1 | 292 | 4/20/2023 |
15.10.11 | 324 | 4/16/2023 |
15.9.40 | 346 | 4/3/2023 |
15.9.1 | 395 | 3/27/2023 |
15.9.0 | 414 | 3/24/2023 |
15.8.2 | 445 | 3/20/2023 |
15.7.0 | 328 | 3/6/2023 |
15.5.20 | 687 | 2/23/2023 |
15.5.13 | 493 | 2/13/2023 |
15.5.9 | 388 | 2/11/2023 |
15.5.2 | 463 | 2/5/2023 |
15.5.1 | 385 | 2/3/2023 |
15.5.0 | 460 | 1/28/2023 |
15.2.0 | 605 | 1/18/2023 |
15.1.0 | 1,069 | 12/28/2022 |
14.5.7 | 615 | 12/13/2022 |
14.5.5 | 716 | 12/6/2022 |
14.5.1 | 550 | 11/23/2022 |
14.5.0 | 497 | 11/18/2022 |
14.4.5 | 572 | 10/22/2022 |
14.4.2 | 509 | 10/22/2022 |
14.4.1 | 505 | 10/22/2022 |
14.4.0 | 532 | 10/17/2022 |
14.3.9 | 552 | 10/13/2022 |
14.3.6 | 561 | 10/7/2022 |
14.3.2 | 570 | 9/18/2022 |
14.3.1 | 659 | 9/12/2022 |
14.3.0 | 542 | 9/10/2022 |
14.1.3 | 814 | 8/7/2022 |
14.1.2 | 554 | 8/7/2022 |
14.1.1 | 562 | 8/7/2022 |
14.0.14 | 550 | 7/26/2022 |
14.0.12 | 544 | 7/24/2022 |
14.0.11 | 524 | 7/23/2022 |
14.0.10 | 539 | 7/23/2022 |
14.0.9 | 524 | 7/23/2022 |
14.0.8 | 610 | 7/17/2022 |
14.0.5 | 680 | 7/11/2022 |
14.0.4 | 612 | 7/7/2022 |
14.0.3 | 604 | 7/2/2022 |
14.0.2 | 549 | 7/2/2022 |
14.0.1 | 863 | 7/2/2022 |
14.0.0 | 573 | 6/25/2022 |
13.4.28 | 566 | 6/11/2022 |
13.4.25 | 669 | 6/9/2022 |
13.4.24 | 567 | 6/9/2022 |
13.4.19 | 613 | 6/8/2022 |
13.4.3 | 595 | 6/6/2022 |
13.4.2 | 626 | 6/4/2022 |
13.4.0 | 652 | 5/31/2022 |
13.3.8 | 626 | 5/19/2022 |
13.3.7 | 585 | 5/18/2022 |
13.3.6 | 628 | 5/14/2022 |
13.3.4 | 702 | 5/9/2022 |
13.3.1 | 637 | 5/1/2022 |
13.3.0 | 598 | 5/1/2022 |
13.2.2 | 653 | 4/25/2022 |
13.2.1 | 611 | 4/25/2022 |
13.2.0 | 639 | 4/21/2022 |
13.1.1 | 658 | 4/20/2022 |
13.1.0 | 725 | 4/7/2022 |
13.0.0 | 669 | 4/5/2022 |
12.0.3 | 832 | 3/14/2022 |
11.0.7 | 709 | 3/11/2022 |
11.0.5 | 757 | 3/2/2022 |
11.0.4 | 684 | 2/22/2022 |
11.0.3 | 685 | 2/9/2022 |
11.0.2 | 740 | 2/6/2022 |
11.0.1 | 732 | 2/5/2022 |
10.0.21 | 699 | 1/28/2022 |
10.0.20 | 717 | 1/27/2022 |
10.0.19 | 699 | 1/23/2022 |
10.0.18 | 667 | 1/17/2022 |
10.0.17 | 680 | 1/14/2022 |
10.0.16 | 532 | 1/2/2022 |
10.0.15 | 589 | 12/31/2021 |
10.0.14 | 601 | 12/28/2021 |
10.0.13 | 671 | 12/23/2021 |
10.0.11 | 462 | 12/23/2021 |
10.0.10 | 481 | 12/22/2021 |
10.0.9 | 639 | 12/22/2021 |
10.0.8 | 520 | 12/22/2021 |
10.0.7 | 683 | 12/22/2021 |
10.0.6 | 560 | 12/19/2021 |
10.0.5 | 655 | 12/18/2021 |
10.0.3 | 445 | 12/16/2021 |
10.0.2 | 524 | 12/14/2021 |
10.0.1 | 410 | 12/13/2021 |
10.0.0 | 461 | 12/6/2021 |
9.9.9 | 1,247 | 11/29/2021 |
9.9.6 | 4,710 | 11/24/2021 |
9.9.5 | 459 | 11/23/2021 |
9.9.4 | 763 | 11/21/2021 |
9.9.3 | 526 | 11/9/2021 |
9.9.2 | 552 | 11/4/2021 |
9.9.0 | 652 | 10/30/2021 |
9.8.9 | 673 | 10/29/2021 |
9.8.7 | 561 | 10/27/2021 |
9.8.6 | 561 | 10/27/2021 |
9.8.5 | 671 | 10/26/2021 |
9.8.4 | 628 | 10/25/2021 |
9.8.3 | 687 | 10/24/2021 |
9.8.1 | 558 | 10/21/2021 |
9.8.0 | 633 | 10/20/2021 |
9.7.9 | 547 | 10/20/2021 |
9.7.8 | 580 | 10/19/2021 |
9.7.7 | 814 | 10/17/2021 |
9.7.6 | 702 | 10/17/2021 |
9.7.5 | 585 | 10/14/2021 |
9.7.1 | 523 | 10/14/2021 |
9.7.0 | 593 | 10/9/2021 |
9.6.8 | 603 | 8/30/2021 |
9.6.7 | 586 | 8/26/2021 |
9.6.6 | 690 | 8/14/2021 |
9.6.5 | 802 | 8/11/2021 |
9.6.4 | 597 | 8/10/2021 |
9.6.3 | 597 | 8/9/2021 |
9.6.2 | 572 | 8/8/2021 |
9.6.1 | 544 | 8/8/2021 |
9.5.9 | 741 | 8/5/2021 |
9.5.8 | 731 | 8/4/2021 |
9.5.3 | 622 | 7/20/2021 |
9.5.0 | 982 | 7/9/2021 |
9.4.5 | 597 | 6/29/2021 |
9.4.4 | 745 | 6/29/2021 |
9.4.0 | 580 | 6/24/2021 |
9.3.7 | 596 | 6/21/2021 |
9.3.6 | 649 | 6/21/2021 |
9.3.5 | 777 | 6/18/2021 |
9.3.4 | 707 | 6/18/2021 |
9.2.5 | 755 | 6/7/2021 |
9.2.4 | 693 | 6/6/2021 |
9.2.3 | 631 | 6/6/2021 |
9.2.2 | 538 | 6/4/2021 |
9.2.1 | 773 | 6/1/2021 |
9.2.0 | 732 | 5/26/2021 |
9.1.9 | 545 | 5/5/2021 |
9.1.8 | 693 | 5/5/2021 |
9.1.7 | 566 | 5/3/2021 |
9.1.4 | 575 | 4/21/2021 |
9.1.2 | 551 | 4/18/2021 |
9.1.1 | 537 | 4/15/2021 |
9.1.0 | 590 | 4/14/2021 |
9.0.1 | 657 | 4/12/2021 |
9.0.0 | 552 | 4/5/2021 |
8.9.92 | 1,135 | 3/30/2021 |
8.9.4 | 1,137 | 3/26/2021 |
8.9.3 | 1,172 | 3/19/2021 |
8.9.2 | 1,161 | 1/29/2021 |
8.9.1 | 1,222 | 1/24/2021 |
8.9.0 | 1,288 | 1/22/2021 |
8.7.1 | 1,595 | 11/15/2020 |
8.7.0 | 1,299 | 11/15/2020 |
8.6.9 | 1,234 | 11/8/2020 |
8.6.7 | 1,209 | 11/4/2020 |
8.6.6 | 1,301 | 11/2/2020 |
8.6.5 | 1,268 | 11/1/2020 |
8.6.3 | 1,289 | 10/30/2020 |
8.6.2 | 1,206 | 10/30/2020 |
8.6.1 | 1,288 | 10/29/2020 |
8.6.0 | 1,241 | 10/28/2020 |
8.5.1 | 1,229 | 10/26/2020 |
8.5.0 | 1,195 | 10/23/2020 |
8.4.6 | 1,404 | 10/20/2020 |
8.4.5 | 1,284 | 10/18/2020 |
8.4.4 | 1,301 | 10/17/2020 |
8.4.3 | 1,278 | 10/16/2020 |
8.4.2 | 1,225 | 10/16/2020 |
8.4.1 | 1,225 | 10/15/2020 |
8.4.0 | 1,311 | 10/13/2020 |
8.3.3 | 1,224 | 10/11/2020 |
8.3.2 | 1,277 | 10/8/2020 |
8.3.1 | 1,286 | 10/5/2020 |
8.3.0 | 1,238 | 10/3/2020 |
8.2.3 | 1,187 | 10/1/2020 |
8.2.2 | 1,475 | 9/26/2020 |
8.2.1 | 1,335 | 9/25/2020 |
8.2.0 | 1,369 | 9/25/2020 |
8.1.25 | 1,265 | 9/24/2020 |
8.1.24 | 1,266 | 9/23/2020 |
8.1.23 | 1,194 | 9/23/2020 |
8.1.22 | 1,257 | 9/21/2020 |
8.1.21 | 1,310 | 9/15/2020 |
8.1.20 | 1,318 | 9/14/2020 |
8.1.19 | 1,304 | 9/13/2020 |
8.1.18 | 1,256 | 9/13/2020 |
8.1.17 | 1,314 | 9/13/2020 |
8.1.16 | 1,303 | 9/13/2020 |
8.1.15 | 1,227 | 9/12/2020 |
8.1.13 | 1,130 | 9/11/2020 |
8.1.12 | 1,257 | 9/11/2020 |
8.1.11 | 1,254 | 9/11/2020 |
8.1.10 | 1,297 | 9/6/2020 |
8.1.9 | 1,303 | 9/3/2020 |
8.1.8 | 1,335 | 9/2/2020 |
8.1.7 | 1,194 | 8/28/2020 |
8.1.4 | 1,186 | 8/25/2020 |
8.1.3 | 1,367 | 8/18/2020 |
8.1.2 | 1,185 | 8/16/2020 |
8.1.1 | 1,245 | 8/15/2020 |
8.0.3 | 1,259 | 8/11/2020 |
8.0.2 | 1,281 | 8/7/2020 |
8.0.1 | 1,286 | 8/7/2020 |
8.0.0 | 1,232 | 8/7/2020 |
7.0.1 | 1,349 | 6/28/2020 |
7.0.0 | 1,326 | 6/28/2020 |
5.0.10 | 1,296 | 5/31/2020 |
5.0.9 | 1,393 | 5/30/2020 |
5.0.8 | 1,278 | 5/29/2020 |
5.0.7 | 1,237 | 5/29/2020 |
5.0.5 | 1,347 | 2/27/2020 |
5.0.4 | 1,304 | 2/26/2020 |
5.0.3 | 1,307 | 2/26/2020 |
5.0.2 | 1,313 | 2/25/2020 |
5.0.1 | 1,205 | 2/25/2020 |
5.0.0 | 1,322 | 2/25/2020 |
4.1.5 | 1,265 | 2/23/2020 |
4.1.4 | 1,346 | 2/23/2020 |
4.1.3 | 1,281 | 2/22/2020 |
4.1.2 | 1,274 | 2/22/2020 |
4.1.1 | 1,262 | 2/21/2020 |
4.1.0 | 1,300 | 2/21/2020 |
4.0.9 | 1,388 | 2/7/2020 |
4.0.8 | 1,221 | 2/7/2020 |
4.0.7 | 1,244 | 2/7/2020 |
4.0.5 | 1,266 | 1/28/2020 |
4.0.4 | 1,389 | 1/27/2020 |
4.0.3 | 1,242 | 1/27/2020 |
4.0.2 | 1,383 | 1/16/2020 |
4.0.1 | 1,401 | 1/11/2020 |
4.0.0 | 1,354 | 1/5/2020 |
3.1.7 | 1,399 | 12/17/2019 |
3.1.6 | 1,306 | 12/12/2019 |
3.1.5 | 1,291 | 12/12/2019 |
3.1.4 | 1,314 | 12/5/2019 |
3.1.3 | 1,338 | 12/4/2019 |
3.1.2 | 1,364 | 11/30/2019 |
3.1.1 | 1,517 | 11/26/2019 |
3.1.0 | 1,317 | 11/10/2019 |
3.0.4 | 1,160 | 11/1/2019 |
3.0.3 | 1,332 | 10/28/2019 |
3.0.2 | 1,344 | 10/28/2019 |
3.0.1 | 1,335 | 10/26/2019 |
3.0.0 | 1,159 | 10/23/2019 |
2.1.4 | 958 | 10/21/2019 |
2.1.3 | 1,291 | 10/21/2019 |
2.1.2 | 1,428 | 10/21/2019 |
2.1.1 | 1,301 | 10/19/2019 |
2.1.0 | 1,348 | 10/19/2019 |
2.0.9 | 1,053 | 10/18/2019 |
2.0.8 | 1,329 | 10/18/2019 |
2.0.7 | 1,050 | 10/18/2019 |
2.0.6 | 1,056 | 10/18/2019 |
2.0.5 | 1,091 | 10/18/2019 |
2.0.4 | 1,055 | 10/17/2019 |
2.0.3 | 1,186 | 10/16/2019 |
2.0.2 | 1,180 | 10/15/2019 |
2.0.1 | 1,221 | 10/14/2019 |
2.0.0 | 969 | 10/13/2019 |
1.1.7 | 1,379 | 10/11/2019 |
1.1.6 | 1,335 | 10/11/2019 |