Caravel 0.27.0
dotnet add package Caravel --version 0.27.0
NuGet\Install-Package Caravel -Version 0.27.0
<PackageReference Include="Caravel" Version="0.27.0" />
paket add Caravel --version 0.27.0
#r "nuget: Caravel, 0.27.0"
// Install Caravel as a Cake Addin #addin nuget:?package=Caravel&version=0.27.0 // Install Caravel as a Cake Tool #tool nuget:?package=Caravel&version=0.27.0
Caravel
This package does not have any external dependency and it brings all basic utilities that every application should handle such as application context or exceptions.
- IUserContext (User)
//Inject IUserContext on constructor.
IUserContext userContext = ...
//Get User Id of the current user.
userContext.UserId();
//Get TenantId of the current tenant. It is useful when dealing with multitenant applications.
userContext.TenantId();
- Handling Errors
var customRawError = new Error("invalid_password", ErrorType.Validation, "Password does not match.", "Password does not match with the username.", Severity.Low);
# recommendation: use the static method to generate errors.
public static Error BookNotFoundError(Guid id) => Error.NotFound("book_not_found", $"Book {id} does not exist.");
- Handling Exceptions
var databaseError = new Error("database_connection", ErrorType.Internal, "Cannot create database connection.", "The database is down.", Severity.Critical);
var exception = new CaravelException(databaseError, innerException);
- DateTime Clock
IClock clock = new DateTimeClock();
var nowUtc = clock.NowUtc();
- Json Serializers
var model = new Dto("Caravel");
var json = await model.SerializeAsync(JsonSerializerConfigurations.CamelCaseSerializer());
- Functional
Result - Use Results instead of throwing exceptions
var result = Result<string>.Success("Success Value")
.Map((success) => success.Length,
(error) => error.Message.Length
);
var result = Result<string>.Failure(new Error("code_error", ErrorType.Validation, "Failure Value"))
.Map((success) => success.Length,
(error) => error.Message.Length
);
Optional - Avoid Nulls using Optional Types
Optional<Product> result = await service.GetProductAsync(id);
return result switch {
Some<Product> p => Ok(p),
_ => NotFound()
};
Either - Improve your error handling by using Either<Error,Success>
Either.Right<Error, Product> result = await service.GetProductAsync(id);
return result.Fold(
(e) => new HttpError(e.Message),
(product) => Ok(product));
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
- No dependencies.
NuGet packages (3)
Showing the top 3 NuGet packages that depend on Caravel:
Package | Downloads |
---|---|
Caravel.AspNetCore
Caravel.AspNetCore is a package that contains common utilities for building asp.net core applications. |
|
Caravel.MediatR
Caravel.MediatR is a package that contains reusable behaviours (validation, logging). |
|
Caravel.EntityFramework
Caravel.EntityFramework contains extension methods that can be reuse across applications.. |
GitHub repositories
This package is not used by any popular GitHub repositories.
Version | Downloads | Last updated |
---|---|---|
0.27.0 | 0 | 10/2/2024 |
0.26.0 | 101 | 9/28/2024 |
0.25.0 | 148 | 8/20/2024 |
0.24.0 | 263 | 12/10/2023 |
0.23.0 | 133 | 12/10/2023 |
0.22.0 | 156 | 12/4/2023 |
0.21.0 | 2,747 | 10/2/2022 |
0.20.0 | 385 | 9/28/2022 |
0.19.0 | 427 | 9/24/2022 |
0.18.0 | 398 | 9/24/2022 |
0.17.0 | 638 | 9/24/2022 |
0.15.0 | 383 | 9/27/2021 |
0.14.0 | 509 | 4/10/2021 |
0.13.0 | 343 | 4/10/2021 |
0.12.0 | 618 | 11/21/2020 |
0.11.0 | 600 | 11/15/2020 |
0.10.0 | 615 | 10/27/2020 |
0.9.0 | 972 | 10/12/2020 |
0.8.0 | 1,197 | 5/29/2020 |
0.7.0 | 554 | 5/16/2020 |
0.6.0 | 401 | 4/24/2020 |
0.5.0 | 585 | 4/11/2020 |
0.4.2 | 595 | 4/11/2020 |
0.4.1 | 623 | 4/10/2020 |
0.4.0 | 779 | 1/27/2020 |
0.3.2 | 899 | 1/11/2020 |
0.3.1 | 599 | 1/11/2020 |
0.3.0 | 598 | 1/11/2020 |
0.2.2 | 703 | 1/4/2020 |
0.2.1 | 631 | 12/26/2019 |
0.2.0 | 643 | 12/26/2019 |
0.1.2 | 536 | 12/26/2019 |
0.1.1 | 530 | 12/24/2019 |
0.1.0 | 481 | 12/21/2019 |