Paralax.CQRS.Commands 1.0.448

dotnet add package Paralax.CQRS.Commands --version 1.0.448
                    
NuGet\Install-Package Paralax.CQRS.Commands -Version 1.0.448
                    
This command is intended to be used within the Package Manager Console in Visual Studio, as it uses the NuGet module's version of Install-Package.
<PackageReference Include="Paralax.CQRS.Commands" Version="1.0.448" />
                    
For projects that support PackageReference, copy this XML node into the project file to reference the package.
<PackageVersion Include="Paralax.CQRS.Commands" Version="1.0.448" />
                    
Directory.Packages.props
<PackageReference Include="Paralax.CQRS.Commands" />
                    
Project file
For projects that support Central Package Management (CPM), copy this XML node into the solution Directory.Packages.props file to version the package.
paket add Paralax.CQRS.Commands --version 1.0.448
                    
#r "nuget: Paralax.CQRS.Commands, 1.0.448"
                    
#r directive can be used in F# Interactive and Polyglot Notebooks. Copy this into the interactive tool or source code of the script to reference the package.
#:package Paralax.CQRS.Commands@1.0.448
                    
#:package directive can be used in C# file-based apps starting in .NET 10 preview 4. Copy this into a .cs file before any lines of code to reference the package.
#addin nuget:?package=Paralax.CQRS.Commands&version=1.0.448
                    
Install as a Cake Addin
#tool nuget:?package=Paralax.CQRS.Commands&version=1.0.448
                    
Install as a Cake Tool

<div align="center">

Paralax Logo

Paralax Framework

.NET 9.0 Build Status NuGet Version Coverage Status

</div>


Overview

The Paralax Framework is a modern, powerful, and modular open-source .NET framework optimized for building microservice architectures. It provides essential components, including encryption, CQRS, logging, messaging, persistence, cloud integration, and HTTP services. Paralax is optimized for .NET 9.0 and integrates seamlessly into cloud-native environments, making it ideal for scalable and resilient distributed systems.

Whether you’re building microservices from scratch or extending existing services, Paralax offers a comprehensive toolkit that is both flexible and easy to integrate.


Key Features

  • Modular and Extensible: Tailor your microservices by using only the components you need.
  • Security-First: Offers encryption, hashing, signing, and secrets management out of the box.
  • Advanced CQRS and Event Sourcing: Full support for the Command-Query Responsibility Segregation (CQRS) pattern and event sourcing for scalable applications.
  • Message Brokering: Seamless integration with RabbitMQ, Kafka, and other message brokers.
  • HTTP & Web API: Robust HTTP client, server support, and API gateway integration.
  • Serialization: Built-in support for both JSON and binary serialization, crucial for optimized data transfer between microservices.
  • Cloud-Native: Optimized for Kubernetes, Docker, and other cloud platforms.
  • Observability: Built-in support for logging, metrics, and distributed tracing using OpenTelemetry and Jaeger.
  • Persistence: Ready-to-use integrations with MongoDB, Redis, and Consul for robust data storage solutions.
  • API Documentation: Integration with Swagger and ReDoc to generate comprehensive API documentation.

Table of Contents


Getting Started

Prerequisites

  • .NET 9.0 SDK or higher: Download .NET 9.0
  • A container platform like Docker or Kubernetes (for cloud-native applications).

Installation

You can install the framework and its core components via NuGet:

dotnet add package Paralax
dotnet add package Paralax.Auth
dotnet add package Paralax.CQRS
dotnet add package Paralax.Logging
dotnet add package Paralax.MessageBrokers

For specialized functionality HTTP, Web API, and message brokers:

dotnet add package Paralax.HTTP
dotnet add package Paralax.WebAPI
dotnet add package Paralax.MessageBrokers.RabbitMQ
dotnet add package Paralax.Tracing.Jaeger

Usage

Once installed, you can start configuring Paralax in your microservices project. Below is an example of configuring logging, tracing, and CQRS with RabbitMQ for message brokering.

public static void Main(string[] args)
{
    var builder = WebApplication.CreateBuilder(args);

    // Add Paralax components
    builder.Services.AddParalaxLogging();
    builder.Services.AddParalaxTracing();
    builder.Services.AddParalaxCQRS();
    builder.Services.AddParalaxMessageBrokerRabbitMQ();

    var app = builder.Build();

    // Middleware setup
    app.UseParalax();

    app.Run();
}

Components

Paralax.Auth

The Paralax.Auth module provides authentication and authorization mechanisms, including JWT-based authentication and OAuth2 integrations.

Paralax.CQRS

This module implements the CQRS (Command-Query Responsibility Segregation) pattern, allowing for scalable, event-driven microservices. It provides:

  • Commands: Handling write operations.
  • Queries: Handling read operations.
  • Events: Implementing event sourcing.

Paralax.MessageBrokers

Supports popular messaging systems like RabbitMQ and Kafka. It enables asynchronous communication between microservices and ensures reliable delivery of messages.

Example:

services.AddParalaxMessageBrokerRabbitMQ(options =>
{
    options.HostName = "rabbitmq.example.com";
});

Paralax.HTTP

Provides a robust HTTP client and server integration, supporting binary serialization of payloads for performance-critical services.

Paralax.WebAPI

A framework built on top of ASP.NET Core Web API, optimized for building APIs with minimal overhead. It integrates binary serialization for efficient communication and supports Swagger for API documentation.

Paralax.Logging

Out-of-the-box logging integration with support for multiple sinks (e.g., Console, Elasticsearch, etc.). It uses best-in-class logging libraries to ensure visibility into your microservices.

Paralax.Tracing

Integrated distributed tracing with OpenTelemetry and Jaeger for monitoring service calls and diagnosing bottlenecks in complex microservice architectures.


Contributing

We welcome contributions from the open-source community! To contribute, please refer to the Contributing Guide for more details on how to get started.

Reporting Issues

If you encounter bugs or issues while using Paralax, please report them through the GitHub Issues page.


License

The Paralax Framework is licensed under the Apache-2.0 License. See the LICENSE file for details.


Credits

The Paralax Framework is maintained by ITSharpPro. We appreciate contributions from developers around the world who help improve the framework for the global development community.

Product 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.  net9.0 is compatible.  net9.0-android was computed.  net9.0-browser was computed.  net9.0-ios was computed.  net9.0-maccatalyst was computed.  net9.0-macos was computed.  net9.0-tvos was computed.  net9.0-windows was computed.  net10.0 was computed.  net10.0-android was computed.  net10.0-browser was computed.  net10.0-ios was computed.  net10.0-maccatalyst was computed.  net10.0-macos was computed.  net10.0-tvos was computed.  net10.0-windows was computed. 
Compatible target framework(s)
Included target framework(s) (in package)
Learn more about Target Frameworks and .NET Standard.

NuGet packages (3)

Showing the top 3 NuGet packages that depend on Paralax.CQRS.Commands:

Package Downloads
Paralax.CQRS.Logging

Paralax.CQRS.Logging - Logging for CQRS in microservices architecture

Paralax.MessageBrokers.CQRS

Paralax.MessageBrokers.CQRS - A framework for integrating CQRS patterns with message brokers in a microservices architecture

Paralax.CQRS.WebApi

Paralax.CQRS.WebApi - CQRS integration for Web API services

GitHub repositories

This package is not used by any popular GitHub repositories.

Version Downloads Last Updated
1.0.448 1,232 2/8/2025
1.0.446 1,236 2/8/2025
1.0.443 240 1/31/2025
1.0.441 212 1/31/2025
1.0.436 314 12/15/2024
1.0.434 296 12/15/2024
1.0.432 143 12/15/2024
1.0.430 144 12/15/2024
1.0.428 149 12/15/2024
1.0.424 141 12/14/2024
1.0.420 215 11/23/2024
1.0.415 255 11/9/2024
1.0.410 203 11/9/2024
1.0.406 192 10/30/2024
1.0.404 194 10/30/2024
1.0.401 254 10/18/2024
1.0.396 213 10/18/2024
1.0.388 145 10/18/2024
1.0.384 144 10/18/2024
1.0.380 130 10/17/2024
1.0.376 134 10/17/2024
1.0.372 132 10/17/2024
1.0.368 142 10/17/2024
1.0.364 142 10/17/2024
1.0.356 606 10/3/2024
1.0.354 589 10/3/2024
1.0.352 139 10/3/2024
1.0.350 151 10/3/2024
1.0.348 144 10/3/2024
1.0.346 148 10/3/2024
1.0.344 178 10/3/2024
1.0.343 165 10/1/2024
1.0.342 147 9/30/2024
1.0.339 146 9/30/2024
1.0.338 157 9/30/2024
1.0.335 209 9/30/2024
1.0.332 127 9/30/2024
1.0.331 150 9/30/2024
1.0.328 143 9/30/2024
1.0.325 132 9/30/2024
1.0.322 143 9/30/2024
1.0.319 163 9/30/2024
1.0.305 151 9/29/2024
1.0.303 121 9/29/2024
1.0.301 153 9/29/2024
1.0.291 127 9/29/2024
1.0.268 137 9/29/2024
1.0.258 171 9/28/2024
1.0.256 155 9/28/2024
1.0.254 147 9/28/2024
1.0.252 134 9/28/2024
1.0.248 117 9/28/2024
1.0.244 150 9/28/2024
1.0.242 127 9/28/2024
1.0.217 132 9/28/2024
1.0.214 127 9/28/2024
1.0.211 132 9/28/2024
1.0.208 126 9/28/2024
1.0.205 136 9/28/2024
1.0.202 128 9/28/2024
1.0.199 139 9/27/2024
1.0.196 121 9/27/2024
1.0.193 137 9/27/2024
1.0.190 137 9/27/2024
1.0.187 119 9/27/2024
1.0.184 145 9/27/2024
1.0.181 151 9/27/2024
1.0.178 135 9/27/2024
1.0.175 160 9/26/2024
1.0.172 129 9/26/2024
1.0.169 153 9/26/2024
1.0.166 294 9/24/2024
1.0.159 140 9/23/2024
1.0.155 126 9/23/2024
1.0.152 142 9/23/2024
1.0.148 145 9/23/2024
1.0.145 138 9/23/2024
1.0.140 352 9/22/2024
1.0.137 127 9/22/2024
1.0.131 132 9/22/2024
1.0.104 128 9/21/2024
1.0.101 141 9/21/2024
1.0.96 123 9/21/2024
1.0.93 134 9/21/2024
1.0.60 130 9/20/2024
1.0.48 126 9/20/2024
1.0.44 121 9/20/2024

Initial release of the Paralax.CQRS.Commands library for managing command handling in scalable CQRS services.