Selena 1.0.2

<div align="center"> <img src="icon.png" alt="Selena Logo" width="128" height="128">

Selena

High-Performance Inter-Process Communication for .NET

Features • Getting Started • Documentation • Benchmarks • Contributing </div>

🚀 Overview

Selena is a zero-dependency, high-performance C# library for inter-process communication (IPC) using Memory-Mapped Files. It enables real-time message exchange between processes with minimal latency and maximum throughput.

✨ Key Features

• 🎯 Zero Dependencies - Pure C# implementation, no external libraries required
• 🌍 Cross-Platform - Works on Windows, Linux, and macOS
• ⚡ High Performance - Up to 600+ MB/s throughput with microsecond latency
• 🔒 Thread-Safe - Built for concurrent multi-threaded scenarios
• 📦 Multiple .NET Versions - Supports .NET 6/7/8 and .NET Standard 2.0/2.1
• 🛡️ Type-Safe - Generic message serialization with built-in type safety
• 🔄 Automatic Recovery - Handles process crashes and reconnections gracefully
• 📊 Real-Time Monitoring - Built-in performance metrics and diagnostics

📋 Requirements

• .NET 6.0+ or .NET Standard 2.0/2.1 compatible runtime
• Windows 7+, Linux (kernel 2.6.22+), or macOS 10.12+
• Administrator privileges for Global scope (Windows only)

🚀 Getting Started

Installation

Install via NuGet Package Manager:

dotnet add package Selena

Or via Package Manager Console:

Install-Package Selena

Quick Example

using Selena.API;

// Create a channel
using var channel = new SelenaChannel("MyChannel");

// Subscribe to messages
channel.MessageReceived += (sender, e) =>
{
    Console.WriteLine($"Received: {e.GetMessageText()}");
};

// Start listening
channel.Start();

// Send a message
await channel.SendMessageAsync("Hello from Selena!");

Advanced Usage

// Configure advanced options
var config = new SelenaConfig
{
    ChannelName = "AdvancedChannel",
    BufferSize = 10 * 1024 * 1024,  // 10MB buffer
    OverflowStrategy = OverflowStrategy.Overwrite,
    ScopeMode = ScopeMode.Local,     // No admin required
    PollingInterval = 5,             // 5ms for Linux/macOS
    EnableJsonLogging = true
};

using var channel = new SelenaChannel(config);

// Send typed objects
var order = new Order { Id = 123, Total = 99.99m };
await channel.SendObjectAsync(order, messageType: 1);

// Receive typed objects
channel.MessageReceived += (s, e) =>
{
    if (e.Message.Header.MessageType == 1)
    {
        var receivedOrder = e.GetMessageObject<Order>();
        Console.WriteLine($"Order #{receivedOrder.Id}: ${receivedOrder.Total}");
    }
};

🏗️ Architecture

graph TB
    subgraph "Process A"
        A1[SelenaChannel] --> A2[Sender]
        A2 --> A3[CircularBuffer]
        A3 --> A4[Memory-Mapped File]
    end
    
    subgraph "Shared Memory"
        A4 <--> MMF[Memory Region]
    end
    
    subgraph "Process B"
        B4[Memory-Mapped File] --> B3[CircularBuffer]
        B3 --> B2[Receiver]
        B2 --> B1[SelenaChannel]
        B4 <--> MMF
    end

📊 Performance Benchmarks

Benchmarks performed on Intel Core i7-10700K, 32GB RAM, NVMe SSD:

Comparison with Other IPC Methods

🛠️ Configuration Options

📚 Examples

Check out the examples directory for complete samples:

• Simple Communication - Basic send/receive
• Chat Application - Multi-process chat
• Performance Benchmark - Throughput testing
• Object Serialization - Type-safe messaging
• Stress Test - High-load scenarios

🤝 Contributing

We welcome contributions! Please see our Contributing Guide for details.

Development Setup

1. Clone the repository

git clone https://github.com/Taiizor/Selena.git
cd Selena

2. Build the project

dotnet build

3. Run tests

dotnet test

4. Run benchmarks

dotnet run -c Release --project tests/Selena.Benchmarks

📝 Documentation

• API Reference
• Architecture Overview
• Performance Tuning
• Troubleshooting
• Migration Guide

🛣️ Roadmap

• Named pipe fallback for unsupported systems
• Compression support for large messages
• Encryption for sensitive data
• Distributed tracing integration
• Unity/Godot engine support
• Web Assembly (WASM) compatibility

📄 License

This project is licensed under the MIT License - see the LICENSE file for details.

🙏 Acknowledgments

• Inspired by various IPC libraries across different platforms
• Thanks to all contributors who have helped shape Selena
• Special thanks to the .NET community for feedback and support

📞 Support

• 📧 Email: taiizor@vegalya.com
• 💬 Discord: Join our community
• 🐛 Issues: GitHub Issues
• 📖 Wiki: GitHub Wiki

<div align="center"> Made with ❤️ by the Selena Community </div>