thenameless314159 / andromeda.network

.NET5 networking library based on BedrockFramework and AspNetCore sources. Provide high performance, low level networking APIs for building custom servers and clients.

Andromeda.Network

This project is based on the Project Bedrock. This project was made only to suits my personal needs, therefore it has some differences with the original :

• No protocol logic, only the base socket layers with the same APIs
• Include latest Microsoft.AspNetCore.Server.Kestrel.Transport.Sockets APIs
• Added configurable logging to server listeners

For further infos about the original project, you can check the presentation here as well as the original repository.

Packages

• Andromeda.Network :
• Andromeda.Framing :
• Andromeda.Framing.Extensions :

Documentation

See the wiki here for futher informations on the framing layer.

andromeda.network's Issues

Replace ReadResult field of PipeFrameDecoder by 3 distinct field with the readresult values directly

Like the MessageReader on the protocol logic of bedrock (to prevent copy of struct ?)

Add library packages to github repo packages

Create a framing library to handle length prefixed protocols

The framing library should provide the following features :

• Implementable frame parser and writer abstractions
• Frame consumption via IAsyncEnumerable
• Frame consumption via single async read
• Synchronized frame reader wrapper around the PipeReader
• Synchronized frame writing wrapper around the PipeWriter
• Unit test the whole library
• Document classes

Add sample applications

Rename IsEmpty func on Frame by IsPayloadEmpty

And add a method IsEmpty to know if the frame is a Frame.Empty or Frame.Empty

Fast path the IFrameEncoder.WriteAsync(IAsyncEnumerable<Frame> frames) ValueTask

Should improve this method using the GetAsyncEnumerator() and trying not to await the MoveNextAsync() calls if possible.

Consider renaming IFrameMetadata to IFrameHeader

Improve/fix read logic when read frame have an incomplete payload

https://github.com/thenameless314159/Andromeda.Network/blob/master/tests/Andromeda.Framing.UnitTests/PipeFrameEncoderDecoderTests.cs#L30

Consider removing cancellation token on WriteAsync(IAsyncEnumerable<Frame> frames)

A token can already be used in the async enumerable using WithCancellation so I assume this might not be needed

Consider making IFrameDecoder interface inherit from IAsyncEnumerable<Frame>

Just for syntax sugar, the GetEnumerator() method will be implemented getting the enumerator from the ReadFramesAsync method