Paralax 1.0.436

dotnet add package Paralax --version 1.0.436                
NuGet\Install-Package Paralax -Version 1.0.436                
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" Version="1.0.436" />                
For projects that support PackageReference, copy this XML node into the project file to reference the package.
paket add Paralax --version 1.0.436                
#r "nuget: Paralax, 1.0.436"                
#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.
// Install Paralax as a Cake Addin
#addin nuget:?package=Paralax&version=1.0.436

// Install Paralax as a Cake Tool
#tool nuget:?package=Paralax&version=1.0.436                

<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. 
Compatible target framework(s)
Included target framework(s) (in package)
Learn more about Target Frameworks and .NET Standard.

NuGet packages (30)

Showing the top 5 NuGet packages that depend on Paralax:

Package Downloads
Paralax.CQRS.Queries

Paralax.CQRS.Queries - Query handling for CQRS in microservices architecture

Paralax.CQRS.Events

Paralax.CQRS.Events - Event handling for CQRS in microservices architecture

Paralax.CQRS.Commands

Paralax.CQRS.Commands - Command handling for CQRS in microservices architecture

Paralax.MessageBrokers

Paralax.MessageBrokers - A framework for handling message-based communication in a microservices architecture

Paralax.WebApi

Paralax.WebApi - Framework for building Web APIs in microservices architecture

GitHub repositories

This package is not used by any popular GitHub repositories.

Version Downloads Last updated
1.0.436 150 21 days ago
1.0.434 265 21 days ago
1.0.432 272 21 days ago
1.0.430 277 21 days ago
1.0.428 266 21 days ago
1.0.424 267 21 days ago
1.0.420 372 a month ago
1.0.415 359 2 months ago
1.0.410 311 2 months ago
1.0.406 351 2 months ago
1.0.404 303 2 months ago
1.0.401 413 3 months ago
1.0.396 304 3 months ago
1.0.388 282 3 months ago
1.0.384 279 3 months ago
1.0.380 278 3 months ago
1.0.376 269 3 months ago
1.0.372 261 3 months ago
1.0.368 283 3 months ago
1.0.364 271 3 months ago
1.0.356 737 3 months ago
1.0.354 316 3 months ago
1.0.352 294 3 months ago
1.0.350 301 3 months ago
1.0.348 291 3 months ago
1.0.346 301 3 months ago
1.0.344 308 3 months ago
1.0.343 310 3 months ago
1.0.342 305 3 months ago
1.0.339 285 3 months ago
1.0.338 295 3 months ago
1.0.335 423 3 months ago
1.0.332 221 3 months ago
1.0.331 285 3 months ago
1.0.328 278 3 months ago
1.0.325 292 3 months ago
1.0.322 316 3 months ago
1.0.319 313 3 months ago
1.0.305 295 3 months ago
1.0.303 300 3 months ago
1.0.301 169 3 months ago
1.0.299 91 3 months ago
1.0.297 209 3 months ago
1.0.295 129 3 months ago
1.0.293 97 3 months ago
1.0.291 94 3 months ago
1.0.285 272 3 months ago
1.0.268 108 3 months ago
1.0.266 289 3 months ago
1.0.264 99 3 months ago
1.0.258 156 3 months ago
1.0.256 255 3 months ago
1.0.254 222 3 months ago
1.0.252 199 3 months ago
1.0.248 262 3 months ago
1.0.246 95 3 months ago
1.0.244 156 3 months ago
1.0.242 197 3 months ago
1.0.214 142 3 months ago
1.0.211 129 3 months ago
1.0.205 178 3 months ago
1.0.202 122 3 months ago
1.0.199 132 3 months ago
1.0.196 130 3 months ago
1.0.193 125 3 months ago
1.0.190 130 3 months ago
1.0.187 110 3 months ago
1.0.184 156 3 months ago
1.0.181 144 3 months ago
1.0.178 129 3 months ago
1.0.175 220 3 months ago
1.0.169 556 3 months ago
1.0.166 302 3 months ago
1.0.159 368 3 months ago
1.0.155 323 3 months ago
1.0.152 246 3 months ago
1.0.148 285 3 months ago
1.0.145 300 3 months ago
1.0.140 424 3 months ago
1.0.137 279 3 months ago
1.0.131 139 3 months ago
1.0.104 396 3 months ago
1.0.101 139 3 months ago
1.0.96 313 3 months ago
1.0.60 142 4 months ago
1.0.48 107 4 months ago
1.0.44 109 4 months ago
1.0.38 119 4 months ago
1.0.36 106 4 months ago
1.0.35 108 4 months ago
1.0.31 109 4 months ago
1.0.28 348 4 months ago
1.0.24 110 4 months ago
1.0.21 102 4 months ago
1.0.19 124 4 months ago

Initial release of the Paralax framework for building scalable services.